deep-plan

Structured clarification before decisions. Use when user is in PLANNING mode, explicitly asks to plan or discuss, or when agent faces choices requiring user input. Ensures agent asks questions instead of making autonomous decisions when multiple valid approaches exist or context is missing.

1.12x

Quality

91%

Does it follow best practices?

Impact

56%

1.12x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Quality

Content

100%

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

The content is a well-structured, actionable instruction-only skill with clear sequencing and a built-in re-check loop, and it stays lean without over-explaining. It fully meets the rubric across all dimensions.

Dimension	Reasoning	Score
Conciseness	The body is lean and scannable with no explaining of concepts Claude already knows and no padding; the one template block is justified and every section earns its place.	3 / 3
Actionability	It gives concrete, copy-paste-ready guidance including a full markdown question-format template with explicit confidence levels ('strongly recommend', 'lean towards') and exact phrasing for handling unanswered questions.	3 / 3
Workflow Clarity	The 7-step process is clearly sequenced with priority batching (blocking -> important -> nice-to-know) and an explicit re-check feedback loop ('STOP and return to clarification mode') for mid-execution ambiguity.	3 / 3
Progressive Disclosure	It is a single, well-organized file with clearly labeled sections and no need for external references, which per the scoring notes can score 3 for a simple skill.	3 / 3
	Total	12 / 12 Passed

Description

82%

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 is clear, third-person, and explicitly pairs a 'Use when...' trigger with what the skill does, which is its main strength. Specificity and distinctiveness are slightly held back by the inherently soft, generic nature of a clarification meta-skill.

Dimension	Reasoning	Score
Specificity	Names the domain ('Structured clarification before decisions') and concrete behaviors ('asks questions instead of making autonomous decisions'), but as a soft process skill it lists a limited set of actions rather than the multiple distinct concrete actions seen in the top anchor.	2 / 3
Completeness	It explicitly answers both what it does (structured clarification, ask questions) and when to use it, opening an explicit 'Use when user is in PLANNING mode, explicitly asks to plan or discuss...' clause.	3 / 3
Trigger Term Quality	It includes natural phrasings a user would say ('plan', 'discuss') plus clear activation conditions ('PLANNING mode', 'choices requiring user input'), giving good coverage of terms users actually use.	3 / 3
Distinctiveness Conflict Risk	The trigger is somewhat specific (PLANNING mode, multiple valid approaches) but as a general clarification behavior it could still overlap with other planning or requirements-gathering skills.	2 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

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: idrevnii/perks
Path: skills/deep-plan/SKILL.md
Commit: 1674a50

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.