docs: slim SKILL.md via progressive disclosure#10
Open
LearnPrompt wants to merge 1 commit into
Open
Conversation
- frontmatter description 1219 → 674 chars (Agent Skills spec caps it at 1024); requires-skills entries reduced to one-liners, verification evidence moved to references/renderer-verification.md - Local demo CLI examples moved to docs/local-demo.md - Operational references shrunk to the runtime-critical shortlist; full annotated index merged into docs/index.md - renderer-specific guidance (rules 14-17) moved to references/renderer-guidance.md - SKILL.md 259 → 161 lines (~4.3k → ~2.6k tokens on trigger) - test_skill_frontmatter_is_valid_yaml now pins the 1024-char cap and the checkup trigger phrases instead of the old description text - docs/v0.9.x-backlog.md: mark all three tasks shipped (v1.0.0/v1.1.0), correct the never-created feat/v0.9-next branch reference Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
为什么
SKILL.md 的 frontmatter description 有 1219 字符，超过 Agent Skills 规范的 1024 字符上限，且 description 是每个会话都注入上下文的部分。正文 259 行中约 40% 是可按需加载的参考资料（CLI 示例、索引、历史指引）。
改了什么
references/renderer-verification.mddocs/local-demo.mddocs/index.mdreferences/renderer-guidance.mdtest_skill_frontmatter_is_valid_yaml改为断言 1024 字符上限 + 触发词（"presentation checkup"、"演讲体检"），把规范约束固化为回归测试docs/v0.9.x-backlog.md：三个任务标注已完成（经 v1.0.0/v1.1.0 落地），修正从未建过的feat/v0.9-next分支引用核心指令（Positioning、AST theory、output contract、OPC workflow、invariants、working rules）原样保留，无行为变更。
验证
python3 -m pytest -q）python3 scripts/smoke_check.py通过🤖 Generated with Claude Code