CtrlK
BlogDocsLog inGet started
Tessl Logo

doc-sync-all

Comprehensive documentation synchronization - scan local git changes and propagate updates to ALL design docs, task lists, specs, diagrams, and planning artifacts. Use when finishing a feature, after merging, or when design docs are out of date.

64

1.03x
Quality

47%

Does it follow best practices?

Impact

93%

1.03x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/doc-sync-all/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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 has a solid structure with both 'what' and 'when' clauses clearly present, which is its strongest aspect. However, the actions described are somewhat high-level ('scan' and 'propagate updates') rather than enumerating specific concrete operations, and the broad scope of artifact types could create overlap with more focused documentation skills. Adding more specific trigger terms and concrete action verbs would strengthen it.

Suggestions

Add more natural trigger term variations users might say, such as 'sync docs', 'update documentation', 'docs are stale', 'refresh specs', or 'docs out of sync with code'.

Make capabilities more specific by listing concrete actions like 'update API specs from code changes', 'mark completed tasks in task lists', 'refresh architecture diagrams' rather than the generic 'propagate updates'.

DimensionReasoningScore

Specificity

Names the domain (documentation synchronization) and some actions ('scan local git changes', 'propagate updates'), but the list of targets ('design docs, task lists, specs, diagrams, and planning artifacts') is more of a category enumeration than specific concrete actions like 'update sequence diagrams' or 'reconcile task completion status'.

2 / 3

Completeness

Clearly answers both 'what' (scan git changes and propagate updates to documentation artifacts) and 'when' with explicit triggers ('Use when finishing a feature, after merging, or when design docs are out of date').

3 / 3

Trigger Term Quality

Includes some natural terms like 'design docs', 'task lists', 'specs', 'out of date', 'merging', and 'finishing a feature', but misses common variations users might say such as 'sync docs', 'update documentation', 'docs are stale', 'README', or 'keep docs in sync'.

2 / 3

Distinctiveness Conflict Risk

The scope is fairly broad ('ALL design docs, task lists, specs, diagrams, and planning artifacts') which could overlap with more targeted documentation skills. However, the git-change-driven synchronization angle provides some distinctiveness. The breadth of artifact types increases conflict risk with individual doc-management skills.

2 / 3

Total

9

/

12

Passed

Implementation

27%

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

This skill is comprehensive in scope but suffers from significant verbosity—it explains processes at a level of detail that assumes low competence, includes project-specific boilerplate (file trees, glob patterns, sample phrases) that inflates token cost, and packs everything into a single file. The workflow is reasonably sequenced but lacks error recovery loops, and much of the guidance is descriptive rather than executable.

Suggestions

Cut content by at least 50%: remove sample invocation phrases, file detection glob patterns, the 'When to Use' section, and the integration section—these add little actionable value and waste tokens.

Split detailed sync rules (3.1-3.7) into a separate SYNC-RULES.md reference file, keeping only a summary table in the main SKILL.md for progressive disclosure.

Add concrete error recovery steps in Phase 4 Step 5: what to do when cross-references are broken, when docs conflict with code, or when a referenced file doesn't exist.

Replace descriptive instructions in 'Apply Updates' (Step 4) with concrete tool invocation examples showing actual replace_string_in_file usage with before/after content.

DimensionReasoningScore

Conciseness

Extremely verbose at ~300+ lines. Explains obvious concepts (what git status does, what documentation is), includes extensive tables mapping generic change types to generic doc types, sample invocation phrases Claude doesn't need, and lengthy file tree listings that are project-specific boilerplate. Much of this could be condensed to 1/3 the length without losing actionable content.

1 / 3

Actionability

Provides concrete bash commands for git analysis and a clear validation pattern for task status, but most guidance is procedural description rather than executable code. The 'Apply Updates' step just names tools without showing usage. The sync rules are structured but remain at the level of 'check if X, then update Y' without concrete implementation examples for most cases.

2 / 3

Workflow Clarity

The 5-phase structure with numbered steps provides a clear sequence, and Phase 4 Step 5 includes verification. However, there are no explicit feedback loops for error recovery (e.g., what to do if cross-references are broken, if a file can't be found, or if updates conflict). The verification step is a checklist without remediation guidance.

2 / 3

Progressive Disclosure

Everything is in a single monolithic file with no bundle files or references to external documents. The content includes extensive file tree listings, glob patterns, sample reports, and detailed sync rules for 7+ document types all inline. This would benefit enormously from splitting sync rules, file patterns, and report templates into separate reference files.

1 / 3

Total

6

/

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
0xrabbidfly/eric-cartman
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.