a-stated-rule-needs-annotated-exceptions
a-stated-rule-needs-annotated-exceptions is a Coding standards & language idioms skill for AI agents, published by maxrave-dev in the kotlin-footguns repository on GitHub. Skillspace rates a-stated-rule-needs-annotated-exceptions D (64/100) and it passed the safety scan; the rating is based on static analysis only.
A design rule with legitimate exceptions survives only if every exception carries its reason at the call site and the rule itself is greppable — otherwise nothing distinguishes an exception from a violation and the rule silently rots. Covers where the rule statement goes, where the reasons go, scoping the audit to the code the rule actually governs, and the limits of a comment-based check. Use when a stated convention is drifting, when reviewers cannot tell deliberate from careless, or before writing a rule into a file header and assuming it will hold.
- Grade
- D
- Quality
- 64 / 100
- Safety
- Passed
- GitHub stars
- 202
Unproven: rated by static analysis only, not yet compared head-to-head.
This rating describes the version of the repository we crawled; it may have changed since, so go by its current files.
Our review
- Architecture
- 100 / 100
- Maturity
- Basic: a single SKILL.md
- Security scan
- Low-risk patterns
- License
- Not declared. Check the repository before reusing it.
What the scanner flagged
- mentions secrets in text
Not checked yet
- Category is a classifier prediction; no model has read this skill yet
- Not judged on the rubric yet (not a contender in its category)
- No blind task eval yet
- Scope (portable / vendor / repo-internal) not assessed; only the top of each category is read for scope
- Sibling files (scripts, references) not fetched; security scan covers SKILL.md only
Skillspace indexes and rates this skill; it does not host or endorse it. Run third-party skills at your own risk.