CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-skill-maintenance

Maintenance procedures for contributing and managing skills within the agent-skills-standard repository — metadata versioning, mirror generation, and release quality gates. For general skill authoring standards, see common-skill-creator.

57

Quality

72%

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 ./.github/skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A lean, command-dense maintenance workflow that is easy to follow and token-efficient, with strong actionability from concrete pnpm commands and exact file/field references. Its weaknesses are the missing error-recovery feedback loop after the validation gates (capping workflow clarity) and reliance on reference files in a sibling skill that cannot be verified from this bundle.

Suggestions

Add an explicit feedback loop after the validation gates, e.g. "If validate:all or an audit fails: fix the canonical skill (not the mirrors), re-run the failed check, and only then re-generate indices" — missing feedback loops for batch operations cap workflow clarity at 3.

Disambiguate the release scripts (when to use release-cli vs release-all-skills vs release:manifest) and extend the versioning policy beyond patch increments to cover new skills or feature-level changes.

Verify the ../common/common-skill-creator/references/ links resolve from this skill's location, or inline the essential template/lifecycle details so the workflow does not depend on unverifiable cross-skill paths.

DimensionReasoningScore

Conciseness

The ~30-line body is lean and assumes Claude's competence: no concept over-explanation, no padding, and every step carries operational content (paths, commands, field names). It matches anchor 5; the only trimmable line is the "Priority: P1 (HIGH)" heading, which is too minor to drop it to anchor 4's "several unnecessary explanations".

5 / 5

Actionability

The guidance is highly concrete — eight copy-paste pnpm commands (validate:all, audit:sdlc, audit:skills, check-alignment, generate-indices, three release scripts) plus exact paths (skills/<category>/<skill-name>/), fields (categories.<category>.version), and formats (YYYY-MM-DD, [Unreleased]). Minor gaps keep it at 4 rather than 5: no guidance on which release script applies in which situation, and the versioning policy only covers patch increments (bugfixes/modernization) without addressing new skills or features.

4 / 5

Workflow Clarity

The five-step sequence (author → bump metadata → sync mirrors → validate → changelog/release) is clearly ordered and includes explicit validation commands, placing it above anchor 3's "checkpoints missing or implicit". However, mirror regeneration and release-all-skills are batch operations across generated directories, and the body provides no error-recovery feedback loop (what to do when validate:all or an audit fails); per the rubric's feedback-loops scoring note, missing feedback loops in batch contexts cap workflow clarity at 3, taking precedence over the otherwise-strong sequencing.

3 / 5

Progressive Disclosure

The body is a clear, well-organized overview with a dedicated "Canonical Authoring References" section linking three one-level-deep reference files with descriptive labels. It falls short of anchor 5 because the referenced files (../common/common-skill-creator/references/TEMPLATE.md, lifecycle.md, resource-organization.md) live in a sibling skill outside this bundle, so the reference paths cannot be verified against actual bundle structure — a minor organization/reliability gap consistent with anchor 4.

4 / 5

Total

16

/

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.

A well-scoped, repository-specific description with a clear "what" and good boundary signaling against the related general-authoring skill. Its main weaknesses are the absent explicit "Use when..." trigger clause and sparse natural-language trigger terms, which cap completeness and trigger-term quality at 3.

Suggestions

Add an explicit trigger clause, e.g. "Use when modifying skills/metadata.json, regenerating agent mirrors, or cutting a release of the skills standard" — the missing 'Use when' clause caps completeness at 3.

Surface natural user phrases in the description itself ("update skills metadata", "sync skill mirrors", "release the skills standard") rather than only in the frontmatter triggers block.

Convert noun-phrase capabilities into concrete verbs with specifics (e.g. "Bump category versions in skills/metadata.json, regenerate agent mirrors with pnpm generate-indices, and run release validation gates") to sharpen specificity.

DimensionReasoningScore

Specificity

The description lists several specific activity areas — "metadata versioning, mirror generation, and release quality gates" — scoped to a named repository, with only minor gaps (changelog recording and validation audits are not mentioned). It sits above anchor 3 (only 1-2 concrete actions) but below anchor 5 (not comprehensive coverage of the maintenance workflow).

4 / 5

Completeness

The "what" is clear (maintenance procedures covering metadata versioning, mirror generation, release quality gates), but there is no "Use when..." clause or equivalent explicit trigger guidance in the description; the pointer to common-skill-creator is a boundary statement, not a trigger. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3, so it cannot score 4 despite the clear 'what'.

3 / 5

Trigger Term Quality

It contains some relevant keywords ("metadata", "mirror", "release", "contributing") but misses the natural phrases a user would say such as "update skills metadata", "sync mirrors", or "cut a release" — those phrases exist only in the frontmatter triggers block, not the description. This matches anchor 3 (some relevant keywords, missing common variations) rather than 4, which requires good coverage of natural terms.

3 / 5

Distinctiveness Conflict Risk

The scope is tightly bounded to "the agent-skills-standard repository" and it explicitly delegates general authoring to common-skill-creator ("For general skill authoring standards, see common-skill-creator"), giving it a mostly distinct niche. It is not a 5 because the closely related common-skill-creator skill overlaps on the general topic of skill contribution, leaving minor conflict risk.

4 / 5

Total

14

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 4 suspicious

Warning

Total

13

/

16

Passed

Repository

HoangNguyen0403/agent-skills-standard

Path

.github/skills/skill-creator/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.