Deprecated¶
These rules are deprecated and will be removed in a future release. They no longer run under enabled: auto; set enabled: true in .skillsaw.yaml to keep running one during the transition. The content rules encoded attention-era heuristics that newer models no longer need; skill-frontmatter is replaced by agentskill-valid.
| Rule ID | Description | Default Severity | Autofix |
|---|---|---|---|
content-critical-position |
Detect critical instructions in the middle of files where LLM attention is lowest | info (deprecated) | - |
content-actionability-score |
Score instruction files on actionability (verb density, commands, file references) | info (deprecated) | - |
skill-frontmatter |
SKILL.md files should have frontmatter with name and description | warning (deprecated) | auto |
Why these rules were deprecated¶
content-critical-position¶
Built on the lost-in-the-middle attention research: instructions in the middle 20–80% of a long file were the most likely to be dropped. Newer models no longer show that attention dip, so moving CRITICAL lines to the edges of a file stopped being worth the churn.
content-actionability-score¶
Scored prose by its ratio of imperative verbs to hedging and descriptive text. The score proved too subjective to drive useful edits — reference material legitimately describes rather than commands — and newer models follow descriptive instructions fine.
skill-frontmatter¶
Superseded by agentskill-valid, which validates the same name and description frontmatter against the agentskills.io specification and carries the same missing-frontmatter autofix — running both reported every problem twice.