CtrlK
BlogDocsLog inGet started
Tessl Logo

staticphp-documentation-sync

Synchronize bilingual documentation when StaticPHP v3 user-facing or developer-facing documentation must change. Use when adding, modifying, deprecating, or removing documented features, CLI commands/options, environment variables, configuration formats, public APIs/extension points, workflows, installation requirements, migration guidance, or user-visible behavior. Do not use solely for internal implementation changes, package/library additions, or build bug fixes unless they change documented behavior or require updating existing docs.

75

Quality

92%

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

85%

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

A well-structured, actionable documentation-sync skill with a clear five-step workflow, explicit validation, concrete commands, and a useful file map and translation rules. The main weakness is minor redundancy between the frontmatter description, the "When to Use" section, the Documentation Map, and the Step 1 table, which keeps conciseness below the top level.

Suggestions

Remove or condense the "When to Use This Skill" bulleted list, since it duplicates the frontmatter description's trigger list almost verbatim; keep only the negative-scope clarification that is not already in the description.

Consolidate the Documentation Map and the Step 1 change-type→file table, or make the Map a quick structural reference and the table the single source of change→affected-file routing, to reduce overlap.

Consider extracting the per-extension/route-specific detail (if any grows) into a reference file later, but for the current size the single-file organization is appropriate.

DimensionReasoningScore

Conciseness

The body is mostly efficient and project-specific (file tree, sidebar filenames, translation rules) without explaining concepts Claude already knows, but the "When to Use This Skill" list substantially duplicates the frontmatter description and the Step 1 mapping table partly overlaps the Documentation Map. This matches the score-2 anchor of mostly efficient but could be tightened, rather than a 3 where every token earns its place.

2 / 3

Actionability

It gives copy-paste-ready commands ("cat docs/en/guide/cli-reference.md", the "diff <(find docs/en -name '*.md' ...)" tree check, "npm run docs:build"), exact file paths, a change-type→file mapping table, and specific translation rules (keep code identical, point Chinese links to "/zh/..."). This matches the score-3 anchor of fully executable commands with specific examples, and is not a 2 because the guidance is concrete rather than pseudocode or abstract.

3 / 3

Workflow Clarity

Five clearly sequenced steps (Identify Impact Scope → Read Current Docs → Update English → Sync Chinese → Validate) lead to an explicit validation checkpoint in Step 5 with concrete checks, and the Common Pitfalls section acts as a checklist. Because validation is present, the batch-operation cap at 2 does not apply, reaching the score-3 anchor of a clear sequence with explicit validation steps and a feedback loop via docs:build.

3 / 3

Progressive Disclosure

No bundle files exist (references/scripts/assets absent), and the ~155-line SKILL.md is a single well-sectioned document (Overview, When to Use, Documentation Map, Workflow, Translation Guidelines, Common Pitfalls) with no deeply nested references. For a procedural skill that needs no external reference files, this matches the score-3 anchor of clear, well-signaled organization with easy navigation, not a 2 where content that should be separate is inline.

3 / 3

Total

11

/

12

Passed

Description

100%

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, third-person description that states a concrete action, supplies an explicit Use-when trigger clause with broad natural coverage, adds negative-scope guidance, and is tightly scoped to a clear niche. No significant weaknesses; the only minor note is that some technical trigger terms (e.g., DI, extension points) assume domain familiarity, but they remain natural for the intended audience.

DimensionReasoningScore

Specificity

"Synchronize bilingual documentation" is a concrete action, and the description enumerates multiple specific change types ("CLI commands/options, environment variables, configuration formats, public APIs/extension points, workflows, installation requirements, migration guidance"), matching the score-3 anchor of listing several specific concrete actions. It is not a 2 because it goes well beyond naming a domain plus a few actions, and 3 is the scale maximum.

3 / 3

Completeness

It answers "what" ("Synchronize bilingual documentation when StaticPHP v3... documentation must change") and "when" with an explicit "Use when..." trigger clause plus negative guidance ("Do not use solely for..."). Because the Use-when clause is present, completeness is not capped at 2, so it reaches the score-3 anchor of clearly answering both what and when with explicit triggers.

3 / 3

Trigger Term Quality

The "Use when adding, modifying, deprecating, or removing documented features, CLI commands/options, environment variables... migration guidance, or user-visible behavior" clause covers natural phrasings a developer would actually say when requesting doc updates. It is not a 2 because it includes common variations rather than only a few relevant keywords, and 3 is the cap.

3 / 3

Distinctiveness Conflict Risk

The niche is tightly scoped to "StaticPHP v3" bilingual (en/zh) documentation sync, with triggers tied to that project's documented surfaces, making it unlikely to fire for unrelated skills. It is not a 2 because the scoping is far more specific than "works with document files," and 3 is the maximum.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
crazywhalecc/static-php-cli
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.