CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plan-composition

Use once the problem and artifacts are understood, to decide the right shape for the context. Produces a short composition plan - a single skill for simple cases, or a plugin with the right mix of skills, rules, hooks, MCP servers, and commands - and confirms it with the user before anything is built.

1.31x
Quality

81%

Does it follow best practices?

Impact

95%

1.31x

Average score across 9 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is tessl/plugin-creator

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 well-crafted, concise planning skill: the workflow is cleanly sequenced with explicit confirmation and stop conditions, decision rules are concrete if/then guidance, and the single reference file is real, well-signaled, and one level deep. The only gaps are minor — some overlap between the body and the reference file, and the absence of a worked example of a finished composition plan.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — short sections, no padding, no explanation of concepts Claude already knows, and actionable heuristics like 'Watch for always-on-convention language: "the agent keeps getting X wrong", "every time"'. It falls short of the every-token-earns-its-place anchor because the body re-states compressed versions of content that also appears in references/choosing-the-shape.md (primitive selection, skill-vs-rule, generic-vs-native hooks), which could be trimmed or deferred.

4 / 5

Actionability

Concrete if/then decision rules ('If the agent should follow a workflow when a relevant task comes up, use a skill'), an explicit plan template ('state: the problem, the artifacts, and the proposed shape, which primitive each part becomes'), a named handoff target ('Pass the confirmed plan to build-composition'), and a stop condition. As an instruction-only skill this is actionable without code, but no worked example of a finished composition plan is provided — matching the mostly-executable-with-minor-gaps anchor rather than the fully-covering-common-cases anchor.

4 / 5

Workflow Clarity

The sequence is unambiguous and in order: choose the primitive, decide the shape, write the plan, confirm with the user ('Confirm with the user, or make the call and tell them your reasoning'), hand off, and stop ('Stop when there is a confirmed composition plan'). Explicit confirmation and stopping checkpoints are present, and this is a planning skill with no destructive or batch operations requiring validation loops.

5 / 5

Progressive Disclosure

The short body serves as an overview and signals its single one-level-deep reference at exactly the right decision point ('See [references/choosing-the-shape.md](references/choosing-the-shape.md)'), and that file exists in the bundle with the deeper rationale (generic vs native hook tiers, verifier guidance, heuristics). Content is appropriately split between the inline decision rules and the deferred depth, making navigation easy.

5 / 5

Total

18

/

20

Passed

Description

67%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 clearly communicates what the skill does and its position in a larger workflow, with a good enumeration of the primitives it chooses among. Its main weakness is the trigger clause: it fires on a pipeline stage ('once the problem and artifacts are understood') instead of natural user phrasing, weakening trigger-term quality and the explicitness of the 'when'.

Suggestions

Replace the pipeline-stage trigger with user-facing triggers, e.g., 'Use when the user asks to build, split, or package a skill or plugin, or when deciding which primitives (skill, rule, hook, MCP server, command) a task needs.'

Add natural trigger variations users would actually say, such as 'build a skill', 'create a plugin', 'turn this into a plugin', or 'should this be a skill or a rule'.

Make 'decide the right shape for the context' more concrete by stating the decision it makes explicitly: choosing between a single skill and a multi-primitive plugin.

DimensionReasoningScore

Specificity

Lists several concrete actions and outcomes — 'Produces a short composition plan - a single skill for simple cases, or a plugin with the right mix of skills, rules, hooks, MCP servers, and commands' and 'confirms it with the user before anything is built'. It falls short of the comprehensive anchor because 'decide the right shape for the context' is abstract phrasing, but it is well above the 1-2-concrete-actions anchor.

4 / 5

Completeness

Both 'what' (produce a short composition plan choosing between a single skill or a plugin with a specific primitive mix) and 'when' (the explicit 'Use once the problem and artifacts are understood' clause, so the missing-trigger cap at 3 does not apply) are stated. The 'when' is explicit but framed as a sequencing condition rather than concrete user-facing triggers, fitting the both-present-but-could-be-more-specific anchor.

4 / 5

Trigger Term Quality

Domain keywords are present ('skill', 'plugin', 'rules', 'hooks', 'MCP servers', 'commands'), but the trigger phrase 'Use once the problem and artifacts are understood' describes an internal pipeline stage rather than language a user would naturally say. Common user variations like 'build a skill', 'create a plugin', or 'package' are missing, matching the some-relevant-keywords-but-missing-variations anchor rather than the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

It carves a clear niche — deciding composition shape before building — and its sequencing trigger ('once the problem and artifacts are understood') distinguishes it from build-stage skills. Minor overlap risk remains with closely related skill-authoring skills (e.g., the 'build-composition' step referenced in the body), so it matches the mostly-distinct anchor rather than the minimal-conflict anchor.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

tesslio/product-plugins

Path

plugin-creator/skills/plan-composition/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.