AgentSkillsCN

writing-for-token-optimized-and-ceo-scannable-content

当在 CEO 的语境下撰写聊天回复、呈现选项与状态,或解释复杂话题时,可灵活运用此方法——提供格式化模式,生成既便于人类阅读、又节省 token 的输出,从而在快速理解的同时,兼顾上下文预算的限制。

SKILL.md
--- frontmatter
name: writing-for-token-optimized-and-ceo-scannable-content
description: Use when writing chat responses under CEO context, presenting options/status, or explaining complex topics - provides formatting patterns for human-scannable, token-efficient output that balances rapid comprehension with context budget constraints

Scannable Token-Efficient Writing

Overview

MECHANISM skill for chat output formatting. Teaches HOW to write scannably (formatting patterns), complements CEO hook (WHEN to be brief) and elements-of-style (prose quality).

Core principle: Front-load decisions, use progressive disclosure, eliminate narrative filler.

When to Use

Chat output:

  • Status updates, options presentation, error explanations
  • Complex topics that risk verbosity

Design doc sections:

  • Problem/Solution/Overview sections → scannable, concise
  • Structure summaries → bullets + diagrams

Comprehensive detail appropriate for:

  • Implementation pseudocode, data contracts, testing strategy
  • Technical debt documentation, whiteboard sections

Token Warning

Loads ~2,000 word reference. Use when output optimization is critical.

Reference

See formatting-reference.md for:

  • Content-Type Decision Matrix
  • Front-loading and visual hierarchy patterns
  • Token reduction techniques
  • Before/after examples
  • Red flags checklist