CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-skills

Use when creating new skills, editing existing skills, or verifying skills work before deployment

Quality

73%

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

Quality

Content

81%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 strong, well-structured process skill: an explicit TDD workflow with validation loops and checklists, concrete testing protocols, and disciplined use of one-level-deep references. The only weaknesses are minor — a duplicated background block, no inline worked test example, and a couple of second-level or external reference hops.

Suggestions

Deduplicate the "REQUIRED BACKGROUND" block (stated once in the Overview and again nearly verbatim before "The Iron Law") into a single pointer.

Inline one short worked example of a baseline pressure scenario or sample subagent prompt so the core testing loop is copy-paste ready without opening the reference.

Guard the ../using-superpowers/references/ cross-skill links with a fallback (or note they apply only when that skill is installed), since they do not resolve in a standalone bundle.

DimensionReasoningScore

Conciseness

Dense, high-signal tables, checklists, and concrete rules with no explanation of concepts Claude already knows. Minor trimmable redundancy: the "REQUIRED BACKGROUND" block appears nearly verbatim twice (Overview and Iron Law sections), and the test-first mandate is restated across the Overview, Iron Law, rationalizations table, STOP section, and checklist.

4 / 5

Actionability

Highly concrete and executable for an instruction skill: TDD mapping table, a numbered micro-test protocol ("5+ reps per variant", "Always include a no-guidance control"), the failure-to-form matching table, a per-phase checklist, and the script-invocation rule ("bash scripts/tool.sh"). Minor gap: no inline worked example of a pressure scenario or sample baseline subagent prompt — that is delegated to references/testing-skills-with-subagents.md.

4 / 5

Workflow Clarity

The RED-GREEN-REFACTOR cycle is explicitly sequenced with validation checkpoints (baseline run without the skill, verification run with the skill, re-test until bulletproof), feedback loops for error recovery, and a mandatory per-skill deployment checklist — a direct match for the anchor-5 pattern. No destructive or batch operations apply, so no cap is triggered.

5 / 5

Progressive Disclosure

All five SKILL.md references (anthropic-best-practices.md, discovery.md, flowcharts.md, bulletproofing.md, testing-skills-with-subagents.md) are real files, one level deep, each with an explicit when-to-read condition, and heavy material (the 1150-line best-practices file) is correctly externalized at 399 body lines. Minor gaps: two references chain to a second level (flowcharts.md → graphviz-conventions.dot; bulletproofing.md → persuasion-principles.md), and the cross-skill links to ../using-superpowers/references/ point outside the bundle and may not resolve.

4 / 5

Total

17

/

20

Passed

Description

56%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 clean, explicit trigger clause with good natural phrasing and a distinct niche, but it omits any statement of what the skill does. Adding a capability clause before the "Use when" trigger would make it complete and raise specificity.

Suggestions

Add a "what" clause before the trigger, e.g.: "Applies test-driven development to skill documentation: baseline-test subagents without the skill, write guidance targeting the observed failures, and re-test until agents comply. Use when creating new skills, editing existing skills, or verifying skills work before deployment."

Include natural trigger synonyms such as "writing skills", "testing a skill", "skill authoring", and "SKILL.md" so the description matches how users actually phrase these requests.

Briefly name the core methodology (TDD / pressure scenarios with subagents) to close the specificity coverage gap.

DimensionReasoningScore

Specificity

Names the skill-authoring domain and three actions ("creating new skills", "editing existing skills", "verifying skills work before deployment"), but the skill's actual methodology (TDD adaptation, subagent pressure-testing, bulletproofing) is entirely absent, so coverage gaps are more than minor.

3 / 5

Completeness

The "when" is explicit and multi-triggered ("Use when creating new skills, editing existing skills, or verifying skills work before deployment"), but no "what" is stated anywhere — nothing describes what the skill does. This matches the anchor-2 case of only "when" present without "what"; it is not 3 because that anchor is the mirror case (clear what, missing when).

2 / 5

Trigger Term Quality

"creating new skills", "editing existing skills", "verifying skills work", and "deployment" are phrases users would naturally say; however common synonyms like "writing skills", "testing a skill", "skill authoring", or "SKILL.md" are missing.

4 / 5

Distinctiveness Conflict Risk

Skill authoring is a clear, narrow niche with distinct triggers (creating/editing/verifying skills); these would not fire for ordinary task skills, and TDD is unmentioned so there is no overlap with TDD-related skills.

5 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 suspicious

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

obra/superpowers

Path

skills/writing-skills/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.