CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-governance

Generate and enforce policy gates for AI coding agents (Copilot, Claude Code) — real-time session hooks that deny protected-path edits and dangerous commands, plus a merge-time backstop for anything that bypasses them. Use when asked to "govern AI agents", "block AI from touching secrets", "add an AI policy gate", or "why did the AI agent hook not fire".

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is ai-governance in nitinjain999/platform-skills

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an unusually executable instruction set: complete configs, a safe idempotent jq merge, exact validation commands with expected outputs, and proactive handling of subtle failure modes (bootstrap ordering, base-branch verifier, GNU/BSD decode portability). Its main weaknesses are a handful of over-long rationale passages that could be tightened, and progressive disclosure — the skill's central reference file and example assets are cited as mandatory but are absent from the bundle, forcing detail to be inlined in SKILL.md instead.

Suggestions

Ship the referenced bundle files: `references/ai-governance.md` is declared mandatory reading ("Read ... before responding") and `examples/ai-governance/evaluate.sh` and `ai-governance-check.yml` are named copy sources, yet no references/ or examples/ directory exists in the skill — include them or inline the minimal content actually needed.

Move mode-specific detail (the check/audit/explain sections, the per-pack protected_paths variants, and the jq settings-merge program) into `references/ai-governance.md`, keeping SKILL.md as the wizard plus a generate-mode overview.

Trim long rationale passages to a single sentence each — e.g., the postToolUse no-op explanation and the audit mode's closing "fleet-visibility value... (Phase 4)" paragraph.

DimensionReasoningScore

Conciseness

The body is dense and operational — no space is spent on concepts Claude already knows, and long passages carry non-obvious project rationale (why postToolUse never re-evaluates, why yq must not be self-installed, why the workflow fetches the base branch's copy). A few passages could still be trimmed — e.g., the ~70-word postToolUse no-op explanation and the audit mode's closing "fleet-visibility value... (Phase 4)" positioning paragraph — which keeps it at anchor 4 rather than the lean anchor 5.

4 / 5

Actionability

Guidance is copy-paste executable throughout: the full `.ai-governance.yaml` policy shape with per-pack deltas, complete `.github/hooks/*.json` configs, a working `jq` merge program with idempotency check, the raw-file `gh api` audit loop, and a Validation block showing exact commands with expected outputs and exit codes ("exit 2" for deny). This matches anchor 5's fully-executable, common-cases-covered standard.

5 / 5

Workflow Clarity

Generate is a 9-step numbered sequence with an explicit Validation block giving expected per-tier outputs, a yq presence check with stop-and-ask fallback, idempotent re-runs ("skipping the append if this exact command is already registered"), and a proactive two-stage bootstrap ordering that prescribes the fix for the known first-PR failure mode — explicit validation plus error-recovery loops, i.e. anchor 5 rather than anchor 4's "minor validation gaps".

5 / 5

Progressive Disclosure

References are clearly signaled ("Read `references/ai-governance.md` before responding", copy sources under `examples/ai-governance/`), but none of these files exist in the skill's bundle — no `references/`, `examples/`, `scripts/`, or `assets/` directory is present — so the mandatory pre-response read is a dangling pointer, and mode-level detail (check/audit/explain, the full jq program, policy pack variants) is inlined rather than split out. Clear signaling (an anchor-4/5 trait) combined with unverifiable references and inline-heavy placement sits at anchor 3.

3 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description explicitly states what the skill does (generate and enforce real-time hooks plus a merge-time backstop), when to use it (four concrete quoted trigger phrases spanning setup and troubleshooting), and stays in third-person imperative voice throughout. It is concise, specific, and follows the strongest reference-example pattern.

DimensionReasoningScore

Specificity

Multiple concrete actions are named: "Generate and enforce policy gates", "real-time session hooks that deny protected-path edits and dangerous commands", "plus a merge-time backstop for anything that bypasses them" — comprehensive coverage of the skill's scope (generation, real-time enforcement, merge-time enforcement), matching the anchor-5 example structure rather than the anchor-4 case which has minor gaps.

5 / 5

Completeness

Both halves are explicit: what ("real-time session hooks that deny protected-path edits and dangerous commands, plus a merge-time backstop") and when ("Use when asked to...") with concrete quoted trigger phrases — a direct match to the anchor-5 good example pattern, not anchor 4 where the 'when' is less specific.

5 / 5

Trigger Term Quality

Natural user phrasings are quoted verbatim — "govern AI agents", "block AI from touching secrets", "add an AI policy gate", and the troubleshooting trigger "why did the AI agent hook not fire" — covering request, blocking, setup, and debug utterances with synonyms, exceeding anchor 4's "good coverage, a few natural terms missing".

5 / 5

Distinctiveness Conflict Risk

The niche is distinct — policy gates for AI coding agents (Copilot, Claude Code) — and the triggers ("govern AI agents", "AI policy gate", "AI agent hook") are phrased around AI-agent governance specifically, so they would rarely be said for a generic security or permissions skill; clear anchor-5 territory.

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

nitinjain999/platform-skills

Path

plugins/platform-skills/skills/ai-governance/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.