CtrlK
BlogDocsLog inGet started
Tessl Logo

crocoder-dev/sce-plan-authoring

Author structured Shared Context Engineering implementation plans.

94

Quality

94%

Does it follow best practices?

Impact

Pending

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 clearly communicates what the skill does (creates structured implementation plans with atomic tasks and acceptance criteria), where outputs go, and when to use it. It includes a comprehensive 'Use when...' clause with diverse natural trigger terms covering features, refactors, integrations, and various synonyms for planning. The SCE-specific naming and output path convention make it highly distinctive.

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/updates SCE implementation plans with atomic tasks, goals, boundaries, acceptance criteria, verification steps) and 'when' with an explicit 'Use when...' clause listing multiple trigger scenarios.

3 / 3

Trigger Term Quality

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

3 / 3

Distinctiveness Conflict Risk

Highly distinctive due to the specific SCE plan format, the output path convention `context/plans/{plan_name}.md`, and the focus on structured pre-execution planning with acceptance criteria. This is unlikely to conflict with general coding, documentation, or task execution skills.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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-crafted skill with strong actionability, clear workflow sequencing, and good progressive disclosure. The clarification gate with blocking semantics and the atomic task slicing contract are particularly effective design choices. Minor verbosity in the clarification gate's enumeration of critical details and some redundancy between the skeleton and filled-in examples prevent a perfect conciseness score, but overall this is a high-quality skill.

DimensionReasoningScore

Conciseness

The skill is mostly efficient and avoids explaining concepts Claude already knows, but some sections are slightly verbose—e.g., the clarification gate's bullet list of critical details could be tightened, and the example task entries, while useful, add length. Overall reasonable but not maximally lean.

2 / 3

Actionability

The skill provides highly concrete, actionable guidance: specific plan format, required task fields, example clarification questions, a filled-in task example with real commands (pnpm test, curl), checkbox syntax, exact output file paths, and a canonical next command. This is copy-paste ready for Claude to follow.

3 / 3

Workflow Clarity

The workflow is clearly sequenced: intake trigger → clarification gate (blocking) → plan writing → output contract. The clarification gate acts as an explicit validation checkpoint with a feedback loop (ask questions, wait, incorporate answers). The required final validation task and the output contract provide clear end-state verification.

3 / 3

Progressive Disclosure

The skill keeps the main content as a concise overview and appropriately references `context/plans/PLAN_EXAMPLE.md` for the full annotated reference plan rather than inlining it. Sections are well-organized with clear headers, and there's no deeply nested referencing. For a skill of this size, the structure is appropriate.

3 / 3

Total

11

/

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