CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chatto-architecture-inventory

Maintain Chatto runtime documentation in docs/architecture/ when runtime structures change, or audit it when requested.

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

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.

An efficient, well-structured instruction skill: lean prose, concrete check targets, explicit verification and reporting steps, and clean routing through the inventory index. The main gaps are the absence of an explicitly ordered step sequence and a recovery path for failed verification.

Suggestions

Number the core workflow (read INDEX → read relevant categories → update affected files → verify claims and links → report) so the sequence is explicit rather than implied by section order.

Add one short example of a well-formed inventory entry (owner, lifecycle, links) to make 'record ownership and lifecycle' concrete without leaving the format entirely to INDEX.md.

Close the verification loop: state what to do when a claim fails verification (fix in place during updates vs. flag as unresolved during reviews), complementing the existing 'do not describe a partial check as a complete audit' rule.

DimensionReasoningScore

Conciseness

The body is lean with zero filler: every line is an instruction, boundary, or check target ('Record code defects separately; inventory work does not authorize implementation changes'), and it assumes Claude's competence throughout. Nothing explains concepts Claude already knows and no section could be cut without losing guidance, matching anchor 5.

5 / 5

Actionability

Concrete and executable for an instruction-only skill: the Source Checks table names specific artifacts ('Subjects()', 'projection_subjects_test.go', 'API.Handlers()', 'API.OperatorHandlers()') and the verification step is explicit ('Verify changed claims against code and check source and document links'). Not anchor 5 because entry format and what a recorded claim looks like are delegated to INDEX.md, leaving minor gaps a reader of SKILL.md alone cannot fill.

4 / 5

Workflow Clarity

A coherent implicit sequence exists (read INDEX → read relevant categories → update or report findings → verify claims and links → report categories checked and unresolved findings) with explicit checkpoints ('Verify changed claims against code', 'Report the categories checked and any unresolved findings'). Not anchor 5 because the steps are never ordered or numbered and there is no error-recovery loop stating what to do when verification finds a stale claim; not anchor 3 because validation checkpoints are explicit, not merely implied.

4 / 5

Progressive Disclosure

The skill is a single ~46-line SKILL.md with no bundle files, well-organized sections, and exactly one clearly signaled one-level-deep reference (docs/architecture/INDEX.md) that routes to per-category detail. This fits the simple-skill pattern where organized sections alone merit a 5.

5 / 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: it names a precise niche, gives two conditioned actions, and pairs each action with an explicit trigger. Only minor gains available from adding a synonym or two ('architecture docs', 'inventory') for broader trigger coverage.

DimensionReasoningScore

Specificity

Names two concrete actions ('Maintain Chatto runtime documentation in docs/architecture/', 'audit it') with an exact path and conditions. Not anchor 5 because 'maintain' and 'audit' are the only actions named — the fuller scope (update, verify, report) lives in the body, leaving minor coverage gaps in the description itself; not anchor 3 because the actions are precise and conditioned rather than generic.

4 / 5

Completeness

Explicitly answers both 'what' (maintain Chatto runtime documentation in docs/architecture/; audit it) and 'when' (when runtime structures change, or when requested), with distinct conditions mapped to each action. This exceeds anchor 4, whose 'when' is generic; it matches anchor 5's requirement of concrete trigger phrases for both.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ('when runtime structures change', 'audit it when requested') plus domain terms 'runtime documentation', 'docs/architecture/', 'audit'. A few natural variations a user might say are missing (e.g., 'update the architecture docs', 'inventory'), keeping it just below comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

'Chatto runtime documentation in docs/architecture/' carves out a clear niche tied to a specific project and path; no other skill would plausibly claim these triggers, so conflict risk is minimal.

5 / 5

Total

18

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

chattocorp/chatto

Path

.agents/skills/chatto-architecture-inventory/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.