CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spek-manage-repos

Add a repo to the current Spektacular project through a guided conversation, inspect the registry, and repair a repo's footprint.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/spek-manage-repos/SKILL.md
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.

The body is an exemplary CLI-workflow skill: copy-paste-ready commands with exact payloads, an explicitly sequenced state-machine loop with validation gates, error-recovery branches for interrupted workflows and broken footprints, and confirmation checkpoints before destructive edits. Its only real weaknesses are the triple-repeated "do not stop after one command" warning and an undifferentiated single file where some reference material could be split out.

Suggestions

Consolidate the repeated "don't stop after one command" guidance (STOP blockquote, loop paragraph, and 'Concretely' paragraph) into a single authoritative statement to trim tokens.

Consider moving the Materialization/staleness and Concepts detail into a references/ file, keeping SKILL.md as a tighter overview with clearly signaled one-level-deep references.

The version-check preamble and trace-span instructions appear before any context about the skill; a brief orientation line before them would aid navigation.

DimensionReasoningScore

Conciseness

Commands are exact and Concepts teaches genuinely novel domain facts (footprint vs. source, colocated/separate repos) Claude cannot already know, but the "don't stop after one command" message is repeated three times (the STOP blockquote, "This is a loop. Do not stop after the first step.", and "Concretely: do not stop after `repo new`."). Not 5 because that repetition is trimmable; not 3 because there is no padding explaining things Claude already knows.

4 / 5

Actionability

Every command is copy-paste ready with exact JSON payloads (`spektacular repo new --data '{"location":"<folder>"}'`, `repo goto --data '{"step":"<current_step>"}'`, the direct `repo add --data '{...}'` form), and the common cases are all covered: guided add, pre-supplied location, interrupted-add resume, fresh start with `--force`, scripting form, footprint repair, and manual removal. Fully executable guidance with no gaps.

5 / 5

Workflow Clarity

The add workflow is a clearly sequenced loop (instruction → step → goto) with explicit validation gates up front (`spektacular version check`, gating on `status: "match"`), feedback loops for error recovery (resume-report `kind` check, `repo_footprint_missing` → repair paths, `--status error` on failed trace spans), and user-confirmation checkpoints before destructive edits ("Confirm with the user before editing their config"). Not 4 because checkpoints and recovery paths are explicit, not merely present.

5 / 5

Progressive Disclosure

The single-file body is well-sectioned (When to invoke / Concepts / Adding / Inspecting / Materialization / Repair / Removal) with no nested or broken references — no bundle files exist to reference. At ~140 lines covering the whole repo surface, content like Materialization and staleness or the Concepts section could arguably live in a separate reference file, a minor organization gap. Not 5 because content is not split at all and the 50-line simple-skill exception doesn't apply; not 3 because structure and navigation are genuinely good.

4 / 5

Total

18

/

20

Passed

Description

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

The description communicates three concrete, domain-specific capabilities in third person with good distinctiveness, but it lacks any explicit "Use when..." trigger guidance and misses natural user phrasings like "register" or "list repos". Adding a trigger clause with concrete user phrases would lift both completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks to add, register, list, or remove a repo, asks where a repo's code lives, or when any repo_footprint error appears."

Include natural user phrasings as triggers ("register the docs repo", "what repos are in this project") to improve trigger-term coverage.

Mention removal via config.yaml edit so the description covers the full repo surface described in the body.

DimensionReasoningScore

Specificity

"Add a repo to the current Spektacular project through a guided conversation, inspect the registry, and repair a repo's footprint" lists three specific concrete actions with clear mechanics, but omits repo removal, a minor coverage gap. Not 5 because the full repo surface (list/remove) isn't covered; not 3 because it goes well beyond naming 1-2 actions.

4 / 5

Completeness

The "what" is clear (three named capabilities with a guided-conversation mechanic), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the "when" is entirely absent rather than merely implicit.

3 / 5

Trigger Term Quality

Relevant keywords are present ("Add a repo", "inspect the registry", "repair a repo's footprint") but common natural variations users would say — "register a repo", "list repos", "what repos are in this project", "remove a repo" — are missing. Not 4 because several natural phrasings are absent; not 2 because the terms present are domain-specific and natural rather than generic.

3 / 5

Distinctiveness Conflict Risk

"Spektacular project", "repo", "footprint" carve a clear niche with repo-scoped triggers, giving minimal conflict risk with unrelated skills. Not 5 because sibling Spektacular skills (init, plans, changelog surfaces) plausibly exist and repo-adjacent phrasing could overlap slightly; not 3 because the scoping is distinctly about repo management.

4 / 5

Total

14

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

nicholasjackson/tcgreplay

Path

skills/spek-manage-repos/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.