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.

Quality

84%

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

75%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 a well-structured, highly actionable standard: concrete exit-code semantics, a class-to-decision table, and a copy-paste template in the bundle. Its main cost is redundancy — the Anti-Patterns and Red Flags sections restate roughly four rules already given in sections 1-5 — and the reference layer chains deeper than the one-level ideal.

Suggestions

Consolidate the Anti-Patterns and Red Flags sections with the rules they restate: merge 'No silent blocks' into §3 Decision Semantics, 'No guardrail without a skill' into §1, and 'No prompt-only rules' into the Priority note, keeping only the recovery actions that add new information.

Present the guardrail-authoring process as an explicit numbered sequence (classify the rule → choose a guardrail class → define exit-code decision semantics → place at team/org level → verify enforcement), including how the fix is verified before the test lock is lifted.

Flatten the reference layer: replace the runtime-adapters.md ↔ untrusted-workspace-admission.md cross-links and the unresolvable ../../common-* links with a single clearly-labeled related-skills note so depth from SKILL.md stays one level.

DimensionReasoningScore

Conciseness

The body is dense and free of padding or explanations of known concepts, but at least four rules are stated two or three times: "Print the rule violated and the sanctioned alternative" (§3) reappears as "No silent blocks: Print the rule and the allowed alternative", "Paired with a skill" returns as "No guardrail without a skill", the Priority statement returns as "No prompt-only rules", and §4's test-lock rules are restated in Red Flags. This matches anchor 3 ("mostly efficient... could be tightened") rather than 4, where duplication would be only minor trim instances.

3 / 5

Actionability

Guidance is directly executable for an instruction-only skill: concrete decision semantics ("Exit 0: allow", "Exit 2: block... on stderr", "fail closed on production classes"), specific deny patterns (".env*, .ssh/, credentials*.json|yaml"), named logging fields ("timestamp, rule, tool, target, and outcome"), and a copy-paste-ready policy skeleton in references/guardrails-template.yaml with per-field comments. Common cases are covered by the class table and host-mapping reference; no gaps remain.

5 / 5

Workflow Clarity

The test-lock flow is sequenced with an explicit verification gate ("Unlock only when the fix is verified") and Red Flags provide recovery loops ("Stop if the fix edits the failing test: Restore the test and fix the production code"), with fail-closed semantics as a checkpoint for unevaluable cases. It is not a 5 because the overall policy-authoring process is implicit across sections rather than an explicit end-to-end sequence, and how the fix is verified before unlocking the test lock is unspecified.

4 / 5

Progressive Disclosure

SKILL.md is a lean overview with clearly signaled references — all three linked files (guardrails-template.yaml, runtime-adapters.md, untrusted-workspace-admission.md) exist and each is annotated with its purpose. It is not a 5 because the reference layer chains onward: runtime-adapters.md and untrusted-workspace-admission.md cross-link each other and point to ../../common-llm-security/SKILL.md and ../../common-security-audit/references/trust-review-policy.md, which do not resolve within this bundle, making effective depth two-plus levels from the entry point.

4 / 5

Total

16

/

20

Passed

Description

88%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: it names the domain with five concrete capability areas, uses an explicit 'Use when...' clause with two concrete trigger situations, and occupies a distinct niche. The only weaknesses are mild — a few natural trigger synonyms are confined to the metadata block, and 'hook policy' has minor overlap risk with adjacent config/security skills.

DimensionReasoningScore

Specificity

The description enumerates five concrete capabilities — "protected paths, test-file locks during bug fixes, post-edit formatters, production approval gates, secret deny rules" — matching the full guardrail class table in the body, so coverage is comprehensive with no gaps. It is not a 4 because the action list has no minor coverage gaps, and voice is third person ("Define..."), so no voice penalty applies.

5 / 5

Completeness

Both halves are explicit: the "what" ("Define deterministic guardrails for agent tool calls — protected paths, test-file locks...") and the "when" ("Use when writing or reviewing a hook policy, or moving an always-do-X rule out of prose into enforcement") with concrete trigger phrases. This matches the anchor-5 pattern exactly; a 4 would require the when-clause to be weaker or less explicit.

5 / 5

Trigger Term Quality

Good natural keyword coverage — "guardrails", "hook policy", "protected paths", "approval gate", "secret deny" — but common variations a user would actually say ("hooks", "PreToolUse", "block edits", "settings.json") appear only in the metadata triggers, not the description itself. This matches anchor 4 ("good keyword coverage; a few natural terms missing") and falls short of anchor 5's comprehensive synonyms and file extensions.

4 / 5

Distinctiveness Conflict Risk

The niche — converting always-hold rules into deterministic hook enforcement — is clear and the trigger "moving an always-do-X rule out of prose into enforcement" is distinctive. However "writing or reviewing a hook policy" is broad enough to overlap with general hook-configuration or security-review skills, matching anchor 4 ("mostly distinct; minor overlap risk with closely related skills") rather than the minimal-conflict anchor 5.

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

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.