Skip to content

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.