skill-decision-support

Present options with trade-offs for informed decision-making — use when choosing between approaches

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/skill-decision-support/SKILL.md

Quality

Content

77%

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

The body is highly actionable with clear templates, worked examples, and a well-sequenced workflow. Its main weaknesses are verbosity from redundant summary/example sections and a monolithic single-file structure with no progressive disclosure.

Suggestions

Trim redundancy: consolidate the Common Patterns examples (which restate the Phase 3/4 templates) and merge the Best Practices, Red Flags, Quick Reference, and Bottom Line into a single concise closing section.

Move the detailed worked-example patterns and the full presentation template into a reference file (e.g. references/examples.md) and point to it from SKILL.md to improve progressive disclosure.

Lead with the single canonical option-presentation template up front and reference it from later phases instead of re-rendering similar structures in each phase.

Dimension	Reasoning	Score
Conciseness	The ~430-line body is structured and accurate but padded with redundancy — the Common Patterns examples largely duplicate the Phase 3/4 templates, and the Best Practices, Red Flags, Quick Reference, and Bottom Line sections restate the same guidance.	2 / 3
Actionability	Concrete copy-paste-ready templates (Pros/Cons/Effort/Risk/Reversibility blocks), specific phrasings ("Which option would you like to proceed with?"), and three fully worked examples (auth fix, caching, TypeScript) give clear executable guidance for an instruction-only skill.	3 / 3
Workflow Clarity	A clearly sequenced five-phase process (Context → Generate Options → Trade-offs → Present → Support) with explicit steps; as this is presentation rather than a destructive/batch operation, the missing error-feedback loop does not cap the score.	3 / 3
Progressive Disclosure	The skill is a single well-organized file with no bundle references, but at >50 lines the lengthy example patterns and best-practice material that could live in a separate reference file are kept inline.	2 / 3
	Total	10 / 12 Passed

Description

67%

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 concisely answers both what the skill does and when to use it with a third-person voice and an explicit trigger clause. It is held back by abstract actions and a narrow set of trigger terms that omit the natural phrasings users actually employ.

Suggestions

Broaden trigger coverage by adding natural phrasings users say, e.g. 'use when the user asks for options, alternatives, or help deciding between approaches'.

Make the stated actions more concrete and varied (e.g. 'generate 2-4 options, analyze pros/cons, recommend with reasoning') rather than the single composite 'present options with trade-offs'.

Sharpen distinctiveness by framing against adjacent skills, e.g. 'use when choosing between approaches — not for open-ended research'.

Dimension	Reasoning	Score
Specificity	"Present options with trade-offs for informed decision-making" names the decision-making domain and two high-level actions (present options, present trade-offs), but these are abstract rather than multiple concrete, distinct actions.	2 / 3
Completeness	Both what ("Present options with trade-offs for informed decision-making") and an explicit when trigger ("use when choosing between approaches") are clearly stated.	3 / 3
Trigger Term Quality	"use when choosing between approaches" and "decision-making" are natural phrases, but common variations users actually say ("what are my options", "help me decide", "alternatives") are missing.	2 / 3
Distinctiveness Conflict Risk	Decision-support/options-presentation is a recognizable niche, but the limited trigger phrasing could still overlap with general advisory or research skills.	2 / 3
	Total	9 / 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: nyldn/claude-octopus
Path: .claude/skills/skill-decision-support/SKILL.md
Commit: 9f39f0c

Reviewed: 2 days 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.