CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

common-agent-guardrails

Define deterministic guardrails for agent tool calls — protected paths, test-file locks during bug fixes, post-edit formatters, production approval gates, secret deny rules. Use when writing or reviewing a hook policy, or moving an always-do-X rule out of prose into enforcement.

72

Quality

90%

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

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

A well-structured, token-efficient standards skill: decision semantics are concrete, the bundle splits cleanly across two genuinely useful reference files, and validation/fail-closed thinking is present throughout. The main gaps are the absence of any inline executable config example and an only implicit end-to-end authoring workflow.

Suggestions

Actionability: inline one small populated example (e.g., a PreToolUse entry in .claude/settings.json implementing the protected-paths or secret-deny class) so the body is copy-paste ready without opening the template.

Workflow_clarity: add a short ordered authoring sequence in the body (choose classes -> populate template -> map adapters per host -> verify with a deliberate violation), pulling the reference's verification step into the main flow.

Actionability: show the exact stderr block-message format once (rule id, violated rule, sanctioned alternative) so exit-2 output is deterministic across guardrails.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence ('Prompts persuade; hooks decide.') with no explanations of concepts Claude already knows; every section carries rule content. The 'Canonical response anchors' section lightly restates terms already used as headers, but it is a deliberate terminology lock, not padding — matching the 5 anchor rather than 4.

5 / 5

Actionability

Concrete, near-executable guidance: exact decision semantics ('Exit 2: block. Print the rule violated and the sanctioned alternative on stderr') and a class/trigger/decision table, with a copyable policy template one reference away. Not 5 because the body itself contains no literal config or hook snippet — a populated example of one guardrail class in .claude/settings.json syntax would make it copy-paste ready. Not 3 because the guidance is specific and executable in substance, not pseudocode or high-level hints.

4 / 5

Workflow Clarity

The test-lock workflow is sequenced with validation checkpoints ('Write the failing test first', 'Unlock only when the fix is verified'), and fail-closed behavior covers the destructive production classes, so the destructive-cap is not triggered. Not 5 because the skill's overall authoring flow — pick classes, fill template, map to host adapters, verify enforcement — is implicit across sections rather than presented as one ordered procedure with an explicit verify step in the body (verification lives in the runtime-adapters reference).

4 / 5

Progressive Disclosure

The ~75-line body keeps the standard inline and delegates correctly: 'Guardrail Policy Template' -> references/guardrails-template.yaml and 'Runtime Adapters' -> references/runtime-adapters.md, both real files, clearly signaled in a References section, one level deep, with no nested references. This matches the 5 anchor's clear overview with well-signaled one-level-deep references.

5 / 5

Total

18

/

20

Passed

Description

92%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, comprehensive, third-person, with an explicit and well-phrased 'Use when' trigger clause. Its only weakness is that the richest trigger vocabulary (file names, hook event names) lives in metadata triggers rather than the description text itself.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'protected paths, test-file locks during bug fixes, post-edit formatters, production approval gates, secret deny rules' — covering the domain comprehensively, matching the 5 anchor rather than 4 because there are no notable coverage gaps.

5 / 5

Completeness

It explicitly answers both: 'what' — define deterministic guardrails with five enumerated classes — and 'when' — 'Use when writing or reviewing a hook policy, or moving an always-do-X rule out of prose into enforcement.' The when-clause contains concrete trigger phrases, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

Good natural terms ('hook policy', 'guardrails', 'approval gates', 'protected paths') that users would plausibly say, but common variations and concrete artifacts like 'PreToolUse', 'hooks.json', or '.claude/settings.json' appear only in metadata triggers, not the description itself. Not 3 because keyword coverage is solid, not partial; not 5 because synonyms and file names a user would mention are missing from the description.

4 / 5

Distinctiveness Conflict Risk

Clear niche (deterministic hook-enforced rules vs. prose instructions) with distinct triggers ('hook policy', 'moving an always-do-X rule out of prose into enforcement'); minimal conflict risk with other skills. The neighboring 4 anchor's 'minor overlap risk' does not apply because the scope is sharply bounded.

5 / 5

Total

19

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

HoangNguyen0403/agent-skills-standard

Path

.agents/skills/common/common-agent-guardrails/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.