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

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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.

An exceptionally actionable, well-sequenced operational skill — copy-paste-ready code with expected outputs and thoughtful failure-mode handling in every mode. Its weaknesses are density (justification prose that should be trimmed) and progressive disclosure: the body carries detail that belongs in references/ai-governance.md, and none of the referenced bundle files actually exist in the bundle.

Suggestions

Ship the referenced bundle files (references/ai-governance.md, examples/ai-governance/evaluate.sh, examples/ai-governance/ai-governance-check.yml) or remove the instructions that depend on them — the skill currently tells Claude to read and copy files that are not present.

Move the tier-table exception, per-mode detail, and evaluator flag semantics into references/ai-governance.md, keeping SKILL.md to the wizard, mode dispatch, and the generate-critical steps.

Trim design-rationale prose (e.g., the yq-provenance paragraph, "degrades in reach, not in kind") to one-line justifications; the operational instruction survives without the editorializing.

DimensionReasoningScore

Conciseness

Mostly efficient — the operational detail (jq merge semantics, bootstrap ordering, tier behavior) is non-obvious — but several passages are padded design-document rationale rather than instruction (e.g., "it degrades in reach, not in kind, without it", the extended yq-provenance justification), so it could be noticeably tightened without losing actionability. Not 2: nothing explains concepts Claude already knows; not 4: multiple paragraphs of justification prose don't earn their tokens.

3 / 5

Actionability

Fully executable throughout: complete YAML policy packs, JSON hook configs, a copy-paste idempotent jq merge script, a gh api scan loop, and validation commands with expected outputs and exit codes ("exit 2 for deny"). Specific examples cover the common cases for every mode.

5 / 5

Workflow Clarity

Each mode is a clearly numbered sequence with explicit validation: a Validation block with expected per-tier outputs, a stop-and-ask checkpoint for missing yq, idempotent re-run design, and an explicitly sequenced two-stage bootstrap that states the failure mode it prevents. Feedback loops are present (tune policy from check results before rollout).

5 / 5

Progressive Disclosure

In-body structure is good (one clearly signaled top-level reference, one level deep, plus per-mode headers), but the referenced bundle files — references/ai-governance.md and every examples/ai-governance/ file it instructs Claude to copy — are absent from the bundle, and ~230 lines of per-mode and tier detail that the reference file should carry are inlined in SKILL.md. Not 4: dangling referenced paths are more than a minor organization gap; not 2: structure is present and the reference is clearly signaled, not buried.

3 / 5

Total

16

/

20

Passed

Description

91%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.

A strong description: concrete capabilities, explicit use-when triggers in natural user phrasing (including a debugging trigger), and a clearly staked-out niche. The only deductions are unmentioned modes (check/audit/explain) and minor overlap with hook-configuration skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Generate and enforce policy gates", "real-time session hooks that deny protected-path edits and dangerous commands", "plus a merge-time backstop" — but omits the check, audit, and explain capabilities the skill actually has, so coverage has minor gaps rather than being comprehensive.

4 / 5

Completeness

It explicitly answers both questions: the first sentence is a clear, concrete "what", and "Use when asked to 'govern AI agents'…" provides explicit "when" guidance with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Four natural quoted trigger phrases — "govern AI agents", "block AI from touching secrets", "add an AI policy gate", "why did the AI agent hook not fire" — cover intent, blocking, setup, and the debugging case, plus tool names (Copilot, Claude Code). This matches the comprehensive-coverage anchor including synonyms, not merely "good keyword coverage with a few terms missing".

5 / 5

Distinctiveness Conflict Risk

The niche is clear (policy gates for AI coding agents with distinct quoted triggers), but the skill also writes Claude Code hook registrations and `.claude/settings.json`, giving it minor overlap risk with hook/permission-configuration skills — one level below minimal-conflict.

4 / 5

Total

18

/

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

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.