CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-skills

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

51

Quality

64%

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

The canonical home for this skill is writing-skills in obra/superpowers

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body delivers strong, actionable TDD-for-skills guidance with explicit validation loops and checklists, but it is roughly twice as long as needed due to repeated guidance blocks, and it cites five bundle files that do not exist — undermining both its token efficiency and its own progressive-disclosure rules.

Suggestions

Deduplicate the description guidance: the 'NEVER summarize workflow' rule and good/bad YAML examples appear in both 'SKILL.md Structure' and 'Claude Search Optimization (CSO)' — keep one canonical set and cross-reference it, and merge the duplicated '### 4.' headings under CSO.

Create the referenced bundle files (testing-skills-with-subagents.md, anthropic-best-practices.md, persuasion-principles.md, render-graphs.js, graphviz-conventions.dot) or remove/inline the citations, and replace the @-style links ('@testing-skills-with-subagents.md', '@graphviz-conventions.dot') with plain references per the skill's own no-@-links rule.

Move the detailed CSO and 'Testing All Skill Types' sections into a separate reference file to bring the main body closer to its own word-count targets, and fix the Discovery Workflow numbering (jumps from 1 to 3).

DimensionReasoningScore

Conciseness

The ~650-line body is noticeably verbose: the 'NEVER summarize the skill's process or workflow' guidance is repeated three times (SKILL.md Structure, CSO section, and examples), the description-format rules are restated in both the CSO section and the checklist, and there are two consecutive '### 4.' headings. This is not a 3 because several entire sections (repeated good/bad YAML example blocks, repeated Iron Law statements) are padding that could be cut without losing information.

2 / 5

Actionability

Mostly concrete and executable: good/bad YAML examples, a rationalization table, runnable commands ('wc -w skills/path/SKILL.md', './render-graphs.js ../some-skill --combine'), and a TodoWrite checklist. It falls short of 5 because the core how-to — writing and running pressure scenarios — is deferred to @testing-skills-with-subagents.md, a file not present in this bundle.

4 / 5

Workflow Clarity

The RED-GREEN-REFACTOR sequence is clearly laid out with explicit validation checkpoints ('Run scenarios WITHOUT skill - document baseline behavior', 'Run scenarios WITH skill - verify agents now comply', 'Re-test until bulletproof') and a checklist. Minor gaps keep it at 4: the Discovery Workflow numbering skips step 2, and the detailed testing methodology lives in a missing file.

4 / 5

Progressive Disclosure

Section structure is good with clear headings, but the reference layer is broken: anthropic-best-practices.md, persuasion-principles.md, testing-skills-with-subagents.md, graphviz-conventions.dot, and render-graphs.js are all referenced yet no references/, scripts/, or assets/ directories exist. It also inlines heavy reference material (the full CSO and testing-type sections) that per its own rules should be split out, so it cannot score 4.

3 / 5

Total

13

/

20

Passed

Description

57%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-structured trigger-only description with concrete, natural conditions and a clear niche, but it omits any statement of what the skill does (its TDD-based methodology), which limits completeness and leaves the description indistinguishable from a generic skill-authoring checklist.

Suggestions

Add a brief 'what' clause (e.g., 'Applies test-driven development to skill authoring: baseline-test agents, write the skill, re-test') alongside the 'Use when' triggers so the description answers both questions.

Broaden trigger synonyms to include 'writing skills', 'authoring skills', and 'updating or testing existing skills' to catch more natural phrasings.

Distinguish the verification trigger from generic skill-testing skills, e.g., 'verifying skills work before deployment (baseline subagent testing)' to reduce overlap risk.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("creating new skills, editing existing skills, or verifying skills work before deployment") with only minor gaps in coverage. It is not a 5 because it omits related activities like testing, structuring, or publishing skills.

4 / 5

Completeness

Only the 'when' is present — "Use when creating... editing... verifying..." — with no statement of what the skill actually does, matching the anchor "only 'when' is present without 'what'. It cannot score 3 because that anchor requires a clear 'what', which is entirely absent here.

2 / 5

Trigger Term Quality

Good natural keyword coverage: "creating new skills", "editing existing skills", "verifying skills work", "before deployment" are phrases a user would naturally say. A few natural terms are missing, such as "writing skills", "authoring", or "updating skills".

4 / 5

Distinctiveness Conflict Risk

The skill-authoring niche is clear and mostly distinct, but "verifying skills work before deployment" has minor overlap risk with closely related skill-testing/verification skills. It lacks the fully distinct trigger set needed for a 5.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (656 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

langbot-app/langbot-docs

Path

.agents/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.