one-three-one-rule

1-3-1 decision briefs: problem, three options, one pick.

Quality

80%

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

Quality

Content

100%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 content is exemplary: lean, fully actionable, with a clearly sequenced workflow, an explicit verification checklist, a revision feedback loop, and well-organized sections that need no external bundle.

Dimension	Reasoning	Score
Conciseness	The body is lean and well-structured, assuming Claude's competence with no padding or explanation of basic decision-making concepts; every line (Procedure bullets, Verification checklist, concrete Example) earns its place.	5 / 5
Actionability	The Procedure gives concrete structural rules (label A/B/C, pros/cons, verifiable DoD, commands in the plan) and the Example is fully copy-paste-ready with file paths, status codes, and specific steps covering the common case.	5 / 5
Workflow Clarity	A clear five-step sequence (Problem → Options → Recommendation → DoD → Implementation Plan) is paired with an explicit Verification checklist and a revision feedback loop when the user picks a different option.	5 / 5
Progressive Disclosure	This single-purpose communication skill has no need for external references (none exist), and its content is organized into clearly headed, easily navigable sections, satisfying the simple-skill exception for progressive disclosure.	5 / 5
	Total	20 / 20 Passed

Description

61%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.

The description is concise and names a distinct, recognizable format with its core structural parts, but omits any explicit "Use when" trigger guidance, capping completeness, and could be enriched with more natural synonyms.

Suggestions

Add a "Use when..." clause naming natural triggers (e.g., "Use when the user asks for a 1-3-1, wants options with trade-offs, or needs a decision proposal to forward to stakeholders").

Broaden trigger-term coverage with synonyms like "trade-offs," "proposal," and "recommendation."

Reflect the fuller output (recommendation with rationale, definition of done, implementation plan) to lift specificity.

Dimension	Reasoning	Score
Specificity	The description names the domain ("1-3-1 decision briefs") and lists its concrete structural components ("problem, three options, one pick"), but does not comprehensively enumerate the fuller capabilities (recommendation rationale, DoD, implementation plan) present in the body.	3 / 5
Completeness	It gives a clear "what" ("1-3-1 decision briefs: problem, three options, one pick") but includes no "Use when..." / "when" trigger guidance, which the rubric caps at 3.	3 / 5
Trigger Term Quality	It includes the natural trigger phrase "1-3-1" plus "decision briefs" and "options" that users would actually say, but misses common synonyms like "proposal," "trade-offs," or "recommendation."	4 / 5
Distinctiveness Conflict Risk	"1-3-1 decision briefs" is a distinctly named format with a specific trigger, giving minimal overlap with other skills, though the trigger surface is somewhat narrow.	4 / 5
	Total	14 / 20 Passed

Validation

81%

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 — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	13 / 16 Passed

Repository: NousResearch/hermes-agent
Path: optional-skills/communication/one-three-one-rule/SKILL.md
Commit: 6680afb

Reviewed: about 4 hours 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.