CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-plans

Use when you have a spec or requirements for a multi-step task, before touching code

Quality

61%

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/harness/adapters/antigravity/skills/writing-plans/SKILL.md

The canonical home for this skill is writing-plans in phatblat/dotfiles

SKILL.md
Quality
Evals
Security

Quality

Content

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

This is an ultra-lean redirect stub: perfectly token-efficient with a clearly signaled one-level pointer, but it delegates 100% of the skill's substance to an external shared-skill path that is not in the bundle and does not exist in this environment. Actionability and workflow clarity are therefore unverifiable from the skill itself, not demonstrably strong.

Suggestions

Inline a minimal summary of the shared skill's core procedure (or bundle it under references/) so the skill remains actionable when the external path is unavailable, as is the case here.

Add a brief overview line stating what the plan format covers (steps, owners, validation) so the SKILL.md functions as an overview rather than a bare pointer.

Use a bundle-relative path (e.g. references/writing-plans.md) instead of an absolute home-directory path, and confirm the referenced file ships with the skill.

DimensionReasoningScore

Conciseness

The body is two sentences plus a generation comment ("Load and follow the shared skill at ~/.agents/skills/writing-plans/SKILL.md") — nothing is over-explained and every token earns its place. It cannot exceed 5, and score 4 ('minor instances of over-explanation') does not apply since there is no padding at all.

5 / 5

Actionability

The single directive is concrete in form (exact path, unambiguous 'Load and follow' instruction), but all substantive guidance for the skill's actual purpose is delegated to a file that is not part of the bundle and does not resolve in this environment — the key details are missing. This fits anchor 3 ('some concrete guidance but incomplete; missing key details') better than 4, whose gaps are only minor.

3 / 5

Workflow Clarity

What is written is one unambiguous step (load the shared skill), but the skill's stated purpose — planning a multi-step task — has no visible sequence, steps, or validation checkpoints in this file; the entire workflow lives behind an unresolvable external pointer. Score 5 under the simple-skill exception does not apply because this is a front for a multi-step process, and anchor 2's 'rough sequence' is also not present — the written directive is clear while the real workflow has implicit, externalized checkpoints.

3 / 5

Progressive Disclosure

The body is a well-signaled, exactly-one-level-deep reference ('Load and follow the shared skill at `~/.agents/skills/writing-plans/SKILL.md`') with nothing buried or nested. It falls short of anchor 5 because there is no overview content at all and the reference points to an absolute path outside the skill bundle rather than co-located files; it is above anchor 3 because the reference is clearly signaled and nothing is inlined that belongs elsewhere.

4 / 5

Total

15

/

20

Passed

Description

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

The description has a clear, explicit trigger clause but omits any statement of what the skill does, leaving it half-complete. Trigger keywords are natural but lack synonyms and breadth. Suggested additions: name the core capability (writing implementation/execution plans) and add natural variations like 'implementation plan', 'task breakdown', or 'project plan'.

Suggestions

Add a concrete 'what' clause, e.g. 'Writes step-by-step implementation plans with owners, milestones, and validation criteria. Use when you have a spec or requirements for a multi-step task, before touching code.'

Broaden trigger-term coverage with natural synonyms users would say, such as 'implementation plan', 'write a plan', 'break this down', or 'task breakdown'.

Sharpen distinctiveness by naming what distinguishes this from generic planning (e.g., 'converts specs into executable coding plans') to reduce overlap with general project-management skills.

DimensionReasoningScore

Specificity

The description names the domain ("spec or requirements for a multi-step task, before touching code") but lists no concrete capability or action — nothing like 'writes implementation plans' or what the skill actually does. It sits above score 1 ('entirely vague; pure abstract language') because the trigger context is concrete, but below score 3, which requires 1-2 named actions.

2 / 5

Completeness

Only the 'when' is present ("Use when you have a spec or requirements..."); the 'what' is entirely missing — the description never states what the skill does. This exactly matches anchor 2 ('only when is present without what'). It is not a 3 because a clear 'what' is absent rather than merely weakly implied, and not a 1 because the 'when' half is explicit and specific.

2 / 5

Trigger Term Quality

"spec", "requirements", "multi-step task", and "before touching code" are natural phrases users would say. However coverage is narrow — common variations like 'implementation plan', 'write a plan', 'break this down', or 'task breakdown' are absent, matching anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than 4.

3 / 5

Distinctiveness Conflict Risk

"spec or requirements for a multi-step task, before touching code" carves out a recognizable niche but still overlaps with general planning, decomposition, and project-management skills. It matches anchor 3 ('somewhat specific but could still overlap with similar skills'); it lacks the distinct multi-action trigger set of anchor 5.

3 / 5

Total

10

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/harness/adapters/antigravity/skills/writing-plans/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.