CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-code-catch-up

This skill should be used when the user says "catch up", "catch-up", "arness code catch up", "retroactive docs", "document old commits", "backfill artifacts", "what did I miss", "undocumented commits", "catch up on commits", "document past work", "backfill records", or wants to retroactively document commits that were made outside the Arness pipeline.

75

Quality

70%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-catch-up/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

62%

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 excels at defining when to use the skill with an extensive list of trigger phrases and occupies a clear niche, but it critically fails to explain what the skill actually does. It reads more like a trigger-matching rule than a skill description, leaving Claude without understanding of the concrete capabilities or outputs involved.

Suggestions

Add a clear 'what it does' statement at the beginning listing specific actions, e.g., 'Scans recent git history for undocumented commits, generates summaries, and creates artifact records for commits made outside the Arness pipeline.'

Restructure to lead with capabilities before the trigger list, e.g., 'Retroactively documents commits by analyzing git logs, generating commit summaries, and backfilling artifact records. Use when...'

DimensionReasoningScore

Specificity

The description lacks concrete actions. It never explains what the skill actually does beyond 'retroactively document commits.' There are no specific capabilities listed like 'generates summaries,' 'creates changelog entries,' or 'updates artifact files.'

1 / 3

Completeness

The 'when' is thoroughly covered with explicit trigger phrases, but the 'what' is extremely weak — it only vaguely mentions 'retroactively document commits that were made outside the Arness pipeline' without explaining what actions the skill performs or what outputs it produces.

2 / 3

Trigger Term Quality

The description is essentially a comprehensive list of trigger phrases including natural variations like 'catch up', 'retroactive docs', 'document old commits', 'backfill artifacts', 'what did I miss', and 'undocumented commits'. These cover many natural ways a user might phrase this request.

3 / 3

Distinctiveness Conflict Risk

The skill occupies a very clear niche — retroactive documentation of commits made outside a specific pipeline ('Arness'). The trigger terms are highly specific and unlikely to conflict with other skills.

3 / 3

Total

9

/

12

Passed

Implementation

77%

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

This is a well-structured, highly actionable skill with clear multi-step workflow sequencing, explicit validation checkpoints, and comprehensive error handling. Its main weakness is moderate verbosity — some inline detail duplicates what the referenced files likely contain, and the skill could be tightened by pushing more algorithmic detail into the reference files. The progressive disclosure structure is sound in design but cannot be fully verified without bundle files.

Suggestions

Move the detailed cross-reference algorithm steps (Step 3 bullets 1-7) into the referenced cross-reference-algorithm.md file and keep only a summary in the main SKILL.md to reduce length and avoid potential duplication.

Remove the repeated instruction about 'confidence: low' and 'populate gaps honestly' which appears both in the numbered list and the bullet point after Step 5's sub-steps.

DimensionReasoningScore

Conciseness

The skill is fairly long (~300 lines) and includes some redundancy (e.g., repeating 'confidence: low' and 'populate gaps honestly' in both the numbered steps and the bullet after). However, most content is genuinely instructional and specific to a non-obvious workflow Claude wouldn't know. Some tightening is possible but it's not egregiously verbose.

2 / 3

Actionability

The skill provides specific git commands (e.g., `git log --format='%H|%aI|%s' --no-merges --after=<scan-start>`), exact directory naming conventions, concrete field names for JSON records, specific thresholds (>80% file overlap, 1-5/6-20/21+ batching tiers), and precise display formats. The guidance is highly concrete and executable.

3 / 3

Workflow Clarity

The workflow is clearly sequenced (Steps 0-7) with explicit validation checkpoints: configuration validation in Step 1, user confirmation with multiple options in Step 4, idempotency checks in Step 3, boundary detection, and a comprehensive error handling section. Feedback loops are present (adjust groupings → re-ask, exclude commits → re-ask). The scan range override offers user control.

3 / 3

Progressive Disclosure

The skill references multiple external files (cross-reference-algorithm.md, catchup-record-format.md, ensure-config.md, template-versioning.md, pattern-refresh.md) which is good progressive disclosure design. However, no bundle files were provided to verify these references exist, and the main SKILL.md itself is quite long — some of the detailed cross-referencing algorithm in Step 3 could arguably live in the referenced file rather than being duplicated/expanded inline.

2 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
AppsVortex/arness
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.