choo121600 opened a new issue, #118:
URL: https://github.com/apache/airflow-steward/issues/118
## Context
Claude Code enforces a per-skill metadata budget of **1,536 characters**
for
`description` + `when_to_use` combined. Skills that exceed this budget get
their frontmatter truncated at routing time, weakening discovery.
#103 trimmed `pr-management-code-review` from **1,708 → 944 chars** using
this principle:
> **Compress depth, preserve surface.**
> Frontmatter is the *routing layer* — keep only trigger phrases, short
task
> descriptions, and routing cues. Rationale, implementation notes, long
> examples, criteria source paths, and sub-step descriptions belong in the
> body.
This meta-issue tracks applying the same audit to every other skill.
## Trimming rules
**Keep in frontmatter**
- Concise trigger phrases (every literal phrase a user might type)
- Routing cues (`use when …`, `skip when …`)
- High-signal task descriptions
**Move to body**
- Rationale / "why"
- Implementation notes
- Long examples
- "Distinct from X" explanations
- Criteria source paths
- Sub-step descriptions
**Non-negotiable:** every literal trigger phrase from the original
`when_to_use` must survive verbatim — including niche ones. Routing recall
must not regress.
## Per-PR checklist
- [ ] PR description shows before/after char counts (`description`,
`when_to_use`, total, budget margin)
- [ ] PR description lists where moved content now lives
- [ ] Trigger phrases preserved verbatim (call this out explicitly)
## Skills to audit
- [ ] `pr-management-mentor` — 1,514 / 1,536 (margin: 22)
- [ ] `setup-isolated-setup-install` — 1,292
- [ ] `security-issue-fix` — 1,249
- [ ] `setup-steward` — 1,231
- [ ] `security-cve-allocate` — 1,197
- [ ] `pr-management-triage` — 1,183
- [ ] `security-issue-import-from-md` — 1,149
- [ ] `setup-shared-config-sync` — 1,138
- [ ] `setup-override-upstream` — 1,096
- [ ] `security-issue-import` — 1,073
- [ ] `security-issue-import-from-pr` — 1,036
- [ ] `write-skill` — 1,036
- [ ] `security-issue-invalidate` — 1,025
- [ ] `setup-isolated-setup-verify` — 1,024
- [ ] `setup-isolated-setup-update` — 996
- [x] `pr-management-code-review` — 944 *(already trimmed in #103)*
- [ ] `security-issue-deduplicate` — 849
- [ ] `security-issue-sync` — 739
- [ ] `pr-management-stats` — 604
## References
- #103 — pattern PR (`pr-management-code-review`)
- #92 — earlier related work
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
