CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-instructions

Create, revise, place, audit, evaluate, and validate repository agent instructions across AGENTS.md, CLAUDE.md, and `.agents/skills`. Use when adding or moving agent rules, deciding whether guidance belongs globally or in a skill or reference, writing or improving a skill, tuning routing descriptions, validating discovery, or reviewing instruction sprawl and composition.

72

Quality

88%

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%

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

A highly actionable, well-sequenced instruction skill with strong reference signaling and validation feedback loops. Its main weaknesses are length/redundancy above its own practical target and one orphaned scripts/ bundle file not surfaced in the body.

Suggestions

Document scripts/audit-routing-collisions.ts in the body with a concrete load condition (e.g. 'Run scripts/audit-routing-collisions.ts when checking for routing collisions after extracting or renaming a skill'), since the skill's own guidance requires scripts to be documented in SKILL.md.

Tighten the body toward the stated 'under 100 lines when practical' target by de-duplicating the overlapping guidance in 'Write The Description First', 'Use Progressive Disclosure', and the Create/Update workflows.

Consolidate the repeated evaluation.md links (currently cited on lines 16, 180, and 191) into a single well-signaled reference to reduce redundancy.

DimensionReasoningScore

Conciseness

The body is dense and project-specific (CLI commands, the .agents/skills path, the 'What Not To Add' list) rather than padded with generic concepts Claude knows, but at ~250 lines it exceeds the skill's own 'under 100 lines when practical' target and repeats guidance across 'Write The Description First', 'Use Progressive Disclosure', and the create/update workflows. Not a 1 because it avoids generic concept explanation; not a 3 because there is redundancy that could be tightened.

2 / 3

Actionability

It gives executable, copy-paste-ready commands ("bun x --package skills skills init <skill-name>", "skills add ... --list"), concrete expected output signals ("Local path validated / Found N skill(s)"), literal directory trees, frontmatter examples, and a 'What Not To Add' list. This matches the 'fully executable commands; copy-paste ready' anchor for an instruction-only skill.

3 / 3

Workflow Clarity

Multi-step processes are explicitly sequenced (Create A Skill, Evaluate A Skill, Update A Skill) with an explicit validation feedback loop ("If the skill does not appear, fix SKILL.md and run the command again") and a closing Review Checklist. This matches the 'clear sequence with explicit validation steps; feedback loops; checklists' anchor.

3 / 3

Progressive Disclosure

The three reference files are well-signaled one-level-deep with concrete load conditions (e.g. "Read references/evaluation.md when tuning trigger descriptions..."), matching anchor-3 quality for references. However the bundle file scripts/audit-routing-collisions.ts exists but is not referenced or documented in the body, a navigation gap the skill's own guidance says to avoid; per the rubric's instruction to score against the actual bundle structure, this caps the score at 2.

2 / 3

Total

10

/

12

Passed

Description

100%

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 actions, explicit 'Use when...' triggers, natural phrasing, and a distinct niche that minimizes routing conflicts. It satisfies every dimension at the top anchor without verbosity.

DimensionReasoningScore

Specificity

It lists multiple concrete actions — "Create, revise, place, audit, evaluate, and validate repository agent instructions" — across named targets (AGENTS.md, CLAUDE.md, .agents/skills), matching the 'lists multiple specific concrete actions' anchor. Not a 2 because the action set is comprehensive rather than partial.

3 / 3

Completeness

It answers both 'what' (create/revise/place/audit/evaluate/validate agent instructions across the named files) and 'when' with an explicit "Use when..." clause listing concrete situations. Not a 2 because the trigger guidance is explicit, not merely implied.

3 / 3

Trigger Term Quality

Natural trigger phrases a user would actually say are well covered: "adding or moving agent rules", "writing or improving a skill", "tuning routing descriptions", "validating discovery", "reviewing instruction sprawl". Not a 2 because it spans the common variations of intent rather than a single keyword.

3 / 3

Distinctiveness Conflict Risk

It owns a clear niche — repository agent-instruction maintenance across AGENTS.md/CLAUDE.md/.agents/skills — with triggers specific to that domain, making conflicts with other skills unlikely. Not a 2 because the triggers are domain-specific rather than broadly overlapping.

3 / 3

Total

12

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 5 missing

Warning

Total

15

/

16

Passed

Repository
EpicenterHQ/epicenter
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.