CtrlK
BlogDocsLog inGet started
Tessl Logo

ideation-sandbox

Safely propose architectural features, unknown unknowns, and brainstorm ideas natively in GitHub Discussions. Triggers: Use this skill when the user asks to brainstorm an architecture change, proposes a highly exploratory / undefined technical idea, or as auto-fire trigger for §5.2 Step 2.5 Architectural Step-Back on high-blast-radius proposals before [RESOLVED_TO_AC] / [GRADUATED_TO_TICKET] graduation.

72

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-3

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

The SKILL.md body is a textbook progressive-disclosure router: maximally lean, concretely actionable, and pointing to a well-structured reference workflow that delivers clear sequencing, validation checkpoints, and feedback loops. The content design is strong; the only residual risk is the reference's many cross-links to non-bundled audits files, but those are supplementary rather than load-bearing.

DimensionReasoningScore

Conciseness

The body is two sentences that assume Claude's competence and explain no background concepts, routing directly to the workflow file — every token earns its place. Not level 2 because there is no unnecessary explanation or padding to tighten.

3 / 3

Actionability

It gives a concrete, copy-paste-ready instruction ("use the `view_file` tool to read ... `.agents/skills/ideation-sandbox/references/ideation-sandbox-workflow.md`") plus a fallback when the payload is already in context, and the referenced workflow file supplies the concrete, executable guidance (specific tools like `create_discussion`, `manage_discussion`, `get_discussion_conversation`). Not level 2 because the routing instruction is specific and complete rather than vague or pseudocode.

3 / 3

Workflow Clarity

The referenced workflow is clearly sequenced (§1 Context → §2 Initial Proposal / Gate 0 → §3–§4 review → §5 graduation criteria → §6 graduation trigger) with explicit validation gates ("Graduation is blocked ...", fold markers, STEP_BACK blockers), an 8-point cross-substrate sweep checklist, and feedback loops (DEFERRED reconciliation, re-poll obligations). Not level 2 because checkpoints and error-recovery loops are explicit, not implicit.

3 / 3

Progressive Disclosure

The body is a lightweight router pointing one level deep to a single, real reference file (verified present), with content appropriately split between a terse SKILL.md and the detailed workflow — matching the level-3 anchor. The reference's cross-links to audits/* are supplementary rationale rather than a nested instruction chain, so the bad 2+-level nesting pattern does not apply.

3 / 3

Total

12

/

12

Passed

Description

75%Weight 40%Scale 1-3

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 answers both 'what' and 'when' with explicit triggers and a distinct niche, but its trigger terms are weighed down by project-internal jargon and its action verbs stay at an exploratory level of abstraction. It is solid but could be sharper for a model scanning for when to invoke it.

Suggestions

Lead the trigger clause with plain user phrasings (e.g., "Use when the user wants to brainstorm or explore an architectural idea before committing to a ticket") and push the §5.2 / [RESOLVED_TO_AC] machinery into the body or a references note so the description stays scannable.

Make the capability verbs more concrete where possible — e.g., "draft an architectural proposal, surface unknown unknowns, and route the discussion to GitHub Discussions" — to lift specificity toward the level-3 anchor.

Define or drop the internal tokens ("high-blast-radius", "auto-fire trigger", graduation tags) from the description; keep only terms a user or model would naturally match against.

DimensionReasoningScore

Specificity

It names a domain and actions ("propose architectural features, unknown unknowns, and brainstorm ideas natively in GitHub Discussions") but the verbs are high-level/exploratory rather than the multiple concrete operations the level-3 anchor calls for (cf. "extract, fill, merge"). Not level 1 because real actions and a concrete substrate (GitHub Discussions) are stated; not level 3 because the actions are abstract, not concrete operations.

2 / 3

Completeness

It explicitly states what the skill does and includes an explicit "Triggers: Use this skill when ..." clause covering multiple trigger conditions, satisfying both the 'what' and 'when' requirements of the level-3 anchor. Not capped at 2 because an explicit 'Use when' clause is present.

3 / 3

Trigger Term Quality

Natural phrases a user might say appear ("brainstorm an architecture change", "highly exploratory / undefined technical idea"), but they are diluted by heavy internal jargon ("§5.2 Step 2.5 Architectural Step-Back", "high-blast-radius proposals", "[RESOLVED_TO_AC] / [GRADUATED_TO_TICKET] graduation", "auto-fire trigger") a user would never say. Not level 1 because some natural trigger terms exist; not level 3 because the jargon crowds out clean coverage of common user phrasings.

2 / 3

Distinctiveness Conflict Risk

The niche is clear — architectural ideation routed to GitHub Discussions with a graduation protocol — and the triggers are scoped enough to avoid firing for unrelated skills. Not level 2 because the architectural + Discussions + graduation framing distinguishes it from generic ideation helpers; the slight genericness of 'brainstorm ideas' is contained by the surrounding architectural context.

3 / 3

Total

10

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
neomjs/neo
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.