CtrlK
BlogDocsLog inGet started
Tessl Logo

crocoder-dev/opencode-sce-plan-authoring

Author structured Shared Context Engineering implementation plans.

93

Quality

93%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that hits all the key criteria. It provides specific concrete actions, comprehensive trigger terms covering natural user language, explicit 'Use when' guidance with multiple scenarios, and a distinctive niche tied to the SCE framework and specific file output format. The description is concise yet thorough, using proper third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: creates/updates structured plans, breaks change requests into scoped atomic tasks, specifies clear goals, boundaries, acceptance criteria, and verification steps. Also specifies the output path format `context/plans/{plan_name}.md`.

3 / 3

Completeness

Clearly answers both 'what' (creates structured implementation plans with atomic tasks, goals, boundaries, acceptance criteria, verification steps) and 'when' with an explicit 'Use when...' clause covering multiple trigger scenarios (planning features, refactors, integrations, needing task breakdowns or roadmaps).

3 / 3

Trigger Term Quality

Includes a strong set of natural keywords users would say: 'plan a new feature', 'refactor', 'integration', 'project plan', 'task breakdown', 'implementation roadmap', 'work plan', 'structured planning', 'change request', 'success criteria'. These cover many natural variations of how users would request planning help.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with the specific SCE framework reference, the output path `context/plans/{plan_name}.md`, and the focus on structured implementation planning with acceptance criteria. This is clearly distinguishable from general coding skills, documentation skills, or project management skills.

3 / 3

Total

12

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured planning skill with strong actionability and clear workflow sequencing. The clarification gate as a blocking checkpoint and the atomic task slicing contract are particularly strong design choices. Minor weaknesses include some redundancy between the skeleton and filled-in examples inline, and the referenced PLAN_EXAMPLE.md is not provided in the bundle, making progressive disclosure harder to fully evaluate.

Suggestions

Provide the referenced `context/plans/PLAN_EXAMPLE.md` bundle file so the full annotated reference plan is actually available, and consider moving the inline skeleton + filled-in example into that file to reduce SKILL.md length.

Consolidate the example task skeleton and the filled-in example into a single filled-in example to reduce redundancy while preserving clarity.

DimensionReasoningScore

Conciseness

The skill is mostly efficient and avoids explaining concepts Claude already knows. However, some sections are slightly verbose—the clarification gate's bullet list of critical details is thorough but could be tightened, and the example clarification questions, while useful, add length. The example task entries are valuable but the skeleton + filled-in example is somewhat redundant.

2 / 3

Actionability

The skill provides highly concrete, actionable guidance: specific plan format, required task fields, a filled-in example task with real commands (`pnpm test`, `curl`), checkbox syntax for progress tracking, exact output path (`context/plans/{plan_name}.md`), and a canonical next command (`/next-task {plan_name} T01`). Very little is left ambiguous.

3 / 3

Workflow Clarity

The workflow is clearly sequenced: intake trigger → clarification gate (blocking) → plan writing → output contract. The clarification gate is an explicit validation checkpoint that blocks progress until ambiguities are resolved. The atomic task slicing contract provides clear rules for splitting work. The required final validation task and output contract close the loop well.

3 / 3

Progressive Disclosure

The skill references `context/plans/PLAN_EXAMPLE.md` for a full annotated reference plan, which is good progressive disclosure. However, no bundle files were provided, so this reference is unverifiable. The main content is reasonably well-structured with clear sections, but the inline examples (skeleton + filled-in task) could potentially be offloaded to the referenced example file to keep the SKILL.md leaner.

2 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents