CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-control-manifest

Builds a short list of must-do and never-do coding rules per system from accepted ADRs. Use when the user wants programmer rules or a cheat sheet from the ADRs, or needs it regenerated after ADR changes.

Quality

89%

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

88%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-gated procedural skill: concrete scripts, exact prompts, an edge-case decision table, and a review-gate feedback loop with explicit verdict handling. The only structural improvement is moving the long output template to a reference file to slim the main body.

DimensionReasoningScore

Conciseness

The body is almost entirely project-specific procedure — commands, decision tables, exact prompts, and the output template — with essentially no explanation of concepts Claude already knows. Minor trimmable instances exist: the layer scope lists appear twice (Phase 2 bullet list and again inside the Phase 5 template's '*Applies to: …*' lines), and passages like 'It always equals Last Updated: the same date, for different readers' are explanatory padding. This fits the score-4 anchor (efficient, minor over-explanation) rather than 5, where every token would earn its place.

4 / 5

Actionability

Guidance is copy-paste executable throughout: 'bash .claude/scripts/adr-status.sh', 'bash .claude/scripts/md-section.sh extract docs/architecture/[adr-file].md "Decision"', exact question wordings with enumerated options ('Options: Yes, write it / Show me the full draft first…'), exact failure messages, verdict lines, and a complete markdown output template. This matches the score-5 anchor (fully executable, specific examples covering the common cases).

5 / 5

Workflow Clarity

Six clearly sequenced phases with explicit validation checkpoints and feedback loops: the Phase 1 counts table is a checklist for every edge case ('Never write an empty manifest silently'), Phase 4 requires user approval before any write, and the verdict loop handles error recovery ('REJECT: write nothing; fix the flagged rules and show the summary again'; 'NOT ASSESSED… supply it and run the review again'), ending with explicit verdict lines. This matches the score-5 anchor including its checklist and error-recovery criteria.

5 / 5

Progressive Disclosure

No bundle files exist, and the body is well-structured with per-phase headers and navigation; all external references (.claude/docs/*, .claude/scripts/*, docs/engine-reference/*) are one level deep and clearly signaled. It is not a 5 because ~100 lines of the Phase 5 output template — content that could live in a references/ file — are inlined in an already ~290-line skill; it is above a 3 because the inline content is the deliverable's own format rather than misplaced reference material.

4 / 5

Total

18

/

20

Passed

Description

87%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: third-person, concise, with an explicit 'Use when' clause carrying natural trigger phrases tied to ADR vocabulary. Minor room to improve by naming the output artifact and adding a few more synonyms for the rules list.

DimensionReasoningScore

Specificity

Concrete actions are stated in third person ('Builds a short list of must-do and never-do coding rules per system from accepted ADRs', 'needs it regenerated after ADR changes') with a clear scope (per system, from Accepted ADRs). Not a 5 because coverage has minor gaps — it omits the artifact it writes (docs/architecture/control-manifest.md) and the review gate; not a 3 because it lists several specific actions rather than just 1-2 with an unspecified remainder.

4 / 5

Completeness

Both what and when are explicitly answered with concrete trigger phrases: what — 'Builds a short list of must-do and never-do coding rules per system from accepted ADRs'; when — 'Use when the user wants programmer rules or a cheat sheet from the ADRs, or needs it regenerated after ADR changes.' This matches the score-5 anchor (clear what + explicit 'Use when' with concrete triggers), not the score-4 anchor where the 'when' is weaker or less specific.

5 / 5

Trigger Term Quality

Natural user phrasings are present: 'the user wants programmer rules', 'a cheat sheet from the ADRs', 'needs it regenerated after ADR changes'. Not a 5 because common synonyms like 'coding standards', 'conventions', or "do's and don'ts" are absent; not a 3 because the included terms are exactly what a user would say, not just domain jargon.

4 / 5

Distinctiveness Conflict Risk

The ADR-derived control-manifest niche has distinct triggers ('from accepted ADRs', 'cheat sheet from the ADRs') that are unlikely to fire for unrelated skills. It matches the score-5 anchor (clear niche with distinct triggers, minimal conflict risk); the score-4 anchor ('minor overlap risk') understates how tightly the triggers are bound to ADR terminology.

5 / 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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

Donchitos/Claude-Code-Game-Studios

Path

.claude/skills/create-control-manifest/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.