Skill audit report

a-stated-rule-needs-annotated-exceptions Audit report.

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.

BLOCKED · BLOCKNeeds reviewGenerated Nov 11, 2026Heuristic metadata audit

Audit

Trust

Quality

Security

Maintain

Install

OpenAgentSkill Trust Score

Manual review

OpenAgentSkill Trust Score

The Trust Score helps an agent decide whether a skill is safe enough to shortlist before installation.

GitHub adoption

INFO

202 GitHub stars

Stars/forks activity

WARN

202 stars, 6 forks; issue activity unavailable in current metadata

Recent maintenance

PASS

2mo since push

License clarity

PASS

GPL-3.0

README/SKILL.md completeness

INFO

Public metadata needs stronger README/SKILL.md context

Dependency/runtime risk

WARN

command execution surface, credential or environment access

Install availability

PASS

npx skills add maxrave-dev/kotlin-footguns --skill a-stated-rule-needs-annotated-exceptions

Install command safety

PASS

standard package or runtime install path

Permission surface

FAIL

secrets or environment access, shell or command execution

Repository evidence

PASS

https://github.com/maxrave-dev/kotlin-footguns/tree/main/skills/a-stated-rule-needs-annotated-exceptions

Review status

WARN

AI review approval is missing

Agent Proven outcomes

INFO

No agent outcome data yet

Checks

Install and adoption review

6 Passed · 13 Needs review

Install path

PASS

npx skills add maxrave-dev/kotlin-footguns --skill a-stated-rule-needs-annotated-exceptions

Repository

PASS

https://github.com/maxrave-dev/kotlin-footguns/tree/main/skills/a-stated-rule-needs-annotated-exceptions

License

PASS

GPL-3.0

Maintenance

PASS

2mo since push

AI review

CHECK

Review approval is missing

README/SKILL.md completeness

PASS

Usable description available

Dependency risk

FIX

command execution surface, credential or environment access

Install command safety

PASS

standard package or runtime install path

Permission surface

FIX

secrets or environment access, shell or command execution

Stars/forks activity

FIX

202 stars, 6 forks; issue activity unavailable in current metadata

Adoption

INFO

202 GitHub stars

Warnings

Dependency or permission surface needs review
Permission surface may require sandboxing
AI review approval is missing
Quality score needs review
Permission surface needs review: secrets or environment access, shell or command execution
Stars/forks activity: 202 stars, 6 forks; issue activity unavailable in current metadata
Dependency/runtime risk: command execution surface, credential or environment access
Permission surface: secrets or environment access, shell or command execution
Review status: AI review approval is missing

Method

This report combines public metadata, AI review output, repository freshness, install readiness, OpenAgentSkill events, quality scoring, trust checks, and the agent safety gate. It is not a full source-code security review.

Install path

Review the report before installing into production agents.

$ npx skills add maxrave-dev/kotlin-footguns --skill a-stated-rule-needs-annotated-exceptions

Agent-readable metadata

Machine decision packet

Embedded JSON exposes suited tasks, suited agents, install command, trust score, safety gate, alternatives, and do-not-use conditions for agent review.

Install policy: block
Best agents: Codex + Claude Code
Alternatives: 3

Open agent JSON

Signals

Audit score: 73/100
Quality: 62/100
Trust: 70/100
Install safety: 92/100
Permission surface: 36/100
Maintenance: 2mo since push
Events: 17 events
GitHub stars: 202
Last push: Aug 29, 2026

Agent safety v2

29/100 · Avoid automatic install

Blocked for auto-installblock

This skill should not be selected by an agent without explicit human security review.

Do not auto-install. Inspect the source, dependencies, and permission surface first.

Metadata combines secrets access with shell or command execution
High-risk permission hints: Shell or command execution, Secrets or environment access

Shell or command execution

high

Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.

Browser automation

medium

Skill may drive a browser or interact with web pages.

Network access

medium

Skill likely fetches remote pages, APIs, repositories, or external services.

Filesystem access

medium

Skill may read or write project files, documents, generated artifacts, or local workspace state.

High-risk permission hints: Shell or command execution, Secrets or environment access
Dependency or permission surface needs review

Back to skill Alternatives Audit badge SVG

Compare nearby options

Related skills to audit next

Wazuh

Wazuh - The Open Source Security Platform. Unified XDR and SIEM protection for endpoints and cloud workloads.

16K Stars · Audit report

Maigret

🕵️‍♂️ Collect a dossier on a person by username from 3000+ sites

33K Stars · Audit report

Nuclei

Nuclei is a fast, customizable vulnerability scanner powered by the global security community and built on a simple YAML-based DSL, enabling collaboration to tackle trending vulnerabilities on the internet. It helps you find vulnerabilities in your applications, APIs, networks, DNS, and cloud configurations.

29K Stars · Audit report