CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-author

Meta-skill para criar, editar, avaliar e otimizar skills do kit. Use quando adicionar nova skill, refatorar skill existente, ou medir qualidade de descoberta de skill (description triggering). Trigger em: "criar nova skill", "nova capacidade", "skill author", "skill creator", "editar skill", "avaliar skill", "skill eval", "otimizar description", "meta-skill", "kit governance".

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

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.

A highly actionable, well-structured meta-skill: complete creation/edit/eval/optimize pipelines with validation gates and feedback loops, concrete commands, and a reusable template. The two residual gaps are mild verbosity in a few meta-commentary spots and the inlined template that the skill's own conventions would place in a separate file.

Suggestions

Move the full SKILL.md template (and optionally the eval criteria table) into a templates/ or references/ file and point to it, following the skill's own convention that reusable templates live outside SKILL.md.

Trim meta-commentary such as the 'Origem: Lessons from building Claude Code' attribution and the motivational intro line to tighten the body without losing guidance.

DimensionReasoningScore

Conciseness

The body is dense, list-driven, and prescriptive, teaching only kit-specific conventions rather than concepts Claude already knows; but a few stretches could be trimmed (motivational intro line, meta-commentary like "Origem: 'Lessons from building Claude Code'"), keeping it short of the 'every token earns its place' anchor. Not 5 for those minor padded spots; not 3 because over-explanation is rare and the ~340 lines stay within the skill's own 300–400 line budget.

4 / 5

Actionability

Copy-paste-ready commands throughout ("ls skills/ | grep -oE '^[0-9]+' | sort -n | tail -5", "node scripts/check-consistency.mjs", "/skill-author --action=eval --skill=skills/05-qa-testing/", "git tag vX.Y.Z -m '...' + gh release create"), a concrete eval table with 0–3 scores and a merge threshold, and a full template with required fields marked — executable guidance covering the common create/edit/eval cases.

5 / 5

Workflow Clarity

A six-phase creation pipeline with explicit validation gates (eval score >= 22 to merge, consistency check "deve passar antes de commit", reviewer handoff in Fase 6), plus an optimization loop with a re-test-until-all-transcripts-trigger feedback cycle and a per-mode 'Evidencia de Conclusao' checklist. Matches the top anchor: clear sequence, explicit validation, feedback loops, checklists.

5 / 5

Progressive Disclosure

Well-organized sections with clear headers, and external resources are clearly signaled and invoked by command (policies files, "node scripts/skill-catalog-budget.mjs", docs/skill-guides/); no bundle files exist to mis-navigate. Not 5: the ~50-line SKILL.md template is inlined in the body even though the skill's own convention says reusable templates belong in templates/, so some content that should be split out is inline.

4 / 5

Total

18

/

20

Passed

Description

96%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 model trigger-oriented description: concrete lifecycle actions on a distinct niche, an explicit 'Use quando' clause, and a bilingual 10-phrase trigger list well within reasonable length (~340 chars). The only weakness is mild overlap risk from the generic 'editar skill'/'avaliar skill' triggers.

DimensionReasoningScore

Specificity

"Meta-skill para criar, editar, avaliar e otimizar skills do kit" lists four concrete lifecycle actions on a specific, well-defined domain (the kit's own skills), matching the comprehensive-coverage anchor. Not 4: the action coverage is complete for the domain rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both what ("Meta-skill para criar, editar, avaliar e otimizar skills do kit") and when ("Use quando adicionar nova skill, refatorar skill existente, ou medir qualidade de descoberta de skill"), reinforced by a concrete "Trigger em:" list — exactly the top anchor's what-and-when-with-trigger-phrases pattern.

5 / 5

Trigger Term Quality

Ten natural trigger phrases spanning both languages users of this kit would actually say ("criar nova skill", "skill author", "skill creator", "skill eval", "otimizar description", "meta-skill", "kit governance"). Not 4: synonyms and near-miss phrasings are covered, with no obviously missing common variation.

5 / 5

Distinctiveness Conflict Risk

Clear niche (operates on the kit's own skills) with distinctive triggers ("skill author", "meta-skill", "kit governance") that other skills would not claim. Not 5: "editar skill" and "avaliar skill" are somewhat generic and carry minor overlap risk with other maintenance/eval skills in the same kit.

4 / 5

Total

19

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_version

'metadata.version' is missing

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

13

/

16

Passed

Repository

felvieira/claude-skills-fv

Path

skills/35-skill-author/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.