CtrlK
BlogDocsLog inGet started
Tessl Logo

sparc-methodology

SPARC development workflow: Specification, Pseudocode, Architecture, Refinement, Completion. A structured approach for complex implementations that ensures thorough planning before coding. Use when: new feature implementation, complex implementations, architectural changes, system redesign, integration work, unclear requirements. Skip when: simple bug fixes, documentation updates, configuration changes, well-defined small tasks, routine maintenance.

58

Quality

66%

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/sparc-methodology/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 is a compact, command-driven overview with concrete executable commands for each SPARC phase, but it pads the frontmatter verbatim, leaves the multi-phase workflow without any validation checkpoints or sequencing rules, and points to bundle files at paths that do not exist in the actual bundle. Fixing the reference paths and adding an explicit phase-order/checkpoint step would raise most dimensions.

Suggestions

Fix the bundle paths: the Scripts table points at '.agents/scripts/sparc-init.sh' and '.agents/scripts/sparc-review.sh' but the files live at 'scripts/sparc-init.sh' and 'scripts/sparc-review.sh'; the References table points at 'docs/sparc.md' and 'docs/sparc-templates.md', which do not exist in the bundle.

Add explicit sequencing and validation to the workflow: state that phases run in order, and wire in the existing 'sparc-review.sh' checklist as a checkpoint between phases (e.g., 'run scripts/sparc-review.sh <feature-dir> and resolve missing phases before proceeding').

Remove the 'Purpose', 'When to Trigger', and 'When to Skip' sections that duplicate the frontmatter description verbatim, reclaiming tokens for a short example of what one phase's output (e.g., a specification) should contain.

DimensionReasoningScore

Conciseness

The Commands section is lean (one-line description + command + example per phase), but three sections — 'Purpose', 'When to Trigger', and 'When to Skip' — duplicate the frontmatter description verbatim, which is pure padding. Not anchor 2 because there is no over-explanation of concepts Claude already knows, and the core content is tight; not anchor 4 because the verbatim frontmatter duplication is a real trimming opportunity.

3 / 5

Actionability

Every phase has a copy-paste-ready command ('npx @claude-flow/cli hooks route --task "specification: ..."') plus a worked example, and the coordinator spawn command is concrete. Not anchor 5 because the commands lack any guidance on what they return or how to act on it, and the supporting materials (phase templates, review checklist usage) are only pointed at, not exemplified.

4 / 5

Workflow Clarity

The five phases appear in order as subsections, so the sequence is implicitly present, but there are no validation checkpoints, no statement that phases must run in order, no error-recovery loop, and no instruction on when to run 'sparc-review' (the checklist script exists but is never wired into the workflow). This matches anchor 3 ('steps listed but validation gaps; checkpoints missing or implicit') and falls short of anchor 4's 'most checkpoints present'.

3 / 5

Progressive Disclosure

The body is a proper overview with clearly signaled one-level-deep references in Scripts and References tables, which is the right shape. However, scored against the actual bundle: the referenced paths '.agents/scripts/sparc-init.sh' and '.agents/scripts/sparc-review.sh' do not match the real bundle location ('scripts/'), and the referenced 'docs/sparc.md' and 'docs/sparc-templates.md' do not exist, so navigation fails. This keeps it below anchor 4 ('minor organization gaps') but above anchor 2, whose failure mode is inlined or buried content.

3 / 5

Total

13

/

20

Passed

Description

75%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 strong description with an explicit what/when/skip structure and natural trigger phrases. Its weaknesses are abstract capability language (planning is described, not what concretely gets produced per phase) and overly broad entry-level triggers that create overlap risk with general development skills.

DimensionReasoningScore

Specificity

The description names the domain ('SPARC development workflow') and enumerates the five phases ('Specification, Pseudocode, Architecture, Refinement, Completion'), but the actual actions remain generic — 'A structured approach for complex implementations that ensures thorough planning before coding' describes intent rather than concrete capabilities. It is above anchor 2 (domain named, actions minimal) because the phase enumeration gives real structure, but below anchor 4, which requires several specific actions with only minor gaps.

3 / 5

Completeness

It explicitly answers both questions: the 'what' ('SPARC development workflow: Specification, Pseudocode, Architecture, Refinement, Completion... thorough planning before coding') and the 'when' via a literal 'Use when:' clause with concrete trigger phrases, plus a bonus 'Skip when:' boundary. This matches anchor 5 ('Clearly and explicitly answers both what AND when with concrete trigger phrases') and exceeds anchor 4, whose 'when' is less specific.

5 / 5

Trigger Term Quality

'new feature implementation, complex implementations, architectural changes, system redesign, integration work, unclear requirements' are phrases users would naturally say when they need a planning-heavy workflow. Not a 5 because common variations like 'refactoring', 'large/complex project', 'planning a build', or 'greenfield' are missing; it is clearly above anchor 3, which only requires some relevant keywords.

4 / 5

Distinctiveness Conflict Risk

Triggers like 'new feature implementation' and 'complex implementations' are broad enough to overlap with general coding, planning, and design skills, so it could still fire for the wrong skill. It is not anchor 4 ('mostly distinct; minor overlap risk') because those two phrases cover most non-trivial development work; the named SPARC methodology and the explicit skip list keep it above anchor 2's very-high-overlap case.

3 / 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
ruvnet/ruflo
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.