Agent skill

Ideation First

by ccplugins in ccplugins/awesome-claude-code-plugins

Use before planning a new feature or greenfield refactor whose requirements aren't yet pinned down — clarifies intent through a few questions and ends with a short scope brief the planner can build…

Apache-2.0Auto-check passedAgent Workflows

Install Ideation First

skills CLI
$ npx skills add ccplugins/awesome-claude-code-plugins --skill ideation-first -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ccplugins/awesome-claude-code-plugins ideation-first --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/craftsman/skills/ideation-first .claude/skills/ideation-first && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ideation-first
GitHub stars
968
Token cost
~926 tokens
SKILL.md length
484 words
Files
1
Skills in repo
66
Repo updated
First seen
Licence
Apache-2.0

At a glance

Use before planning a new feature or greenfield refactor whose requirements aren't yet pinned down — clarifies intent through a few questions and ends with a short scope brief the planner can build…

  • Works in 4 steps: Ask 3–5 clarifying questions, one at a… → Prefer the minimal interpretation. When… → Propose 2–3 approaches when there's a… → …
  • Tasks that involve Brainstorming
  • SKILL.md covers Overview, When this applies, When to skip and The process, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ideation First is an agent skill from ccplugins/awesome-claude-code-plugins. Use before planning a new feature or greenfield refactor whose requirements aren't yet pinned down — clarifies intent through a few questions and ends with a short scope brief the planner can build on.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Brainstorming and Refactoring. The repository describes itself as: Awesome Claude Code plugins — a curated list of slash commands, subagents, MCP servers, and hooks for Claude Code. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Brainstorming
  • Tasks that involve Refactoring

Example prompts

  • “/ideation-first”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Ask 3–5 clarifying questions, one at a time. One question per turn — each answer informs the
  2. Prefer the minimal interpretation. When the request is open-ended, propose the smallest thing
  3. Propose 2–3 approaches when there's a real design fork, each with its trade-off and your
  4. Confirm, then write the scope brief. Once the user agrees, produce the brief below — it

What it can do on your machine

Read from SKILL.md and the folder at commit 5bd4f16. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ideation First loads about 926 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 484 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~926

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ccplugins/awesome-claude-code-plugins at commit 5bd4f16, republished under its Apache-2.0 licence (© ccplugins). 484 words, ~926 tokens.

Download SKILL.mdSave it as .claude/skills/ideation-first/SKILL.md (or your agent's skills folder).
name
ideation-first
description
Use before planning a new feature or greenfield refactor whose requirements aren't yet pinned down — clarifies intent through a few questions and ends with a short scope brief the planner can build on.

Ideation First

Overview

Planning against guessed requirements wastes work. The planner turns a request into ordered steps — but if the request itself is vague, every step is built on a guess, and the further the pipeline runs, the more expensive that guess is to unwind. This skill settles the what before anyone plans the how.

Core principle: clarify the what before planning the how.

When this applies

A request for a new capability, feature, or greenfield refactor whose requirements aren't pinned down — the goal, the boundaries, or the success criteria are open to interpretation. Signals: "build a … screen", "add … support", "let users …", "we need something that …" with no spec.

When to skip

  • Well-specified requests — the goal, inputs, and done-condition are already unambiguous. Don't interrogate when the ask is clear; go straight to planning.
  • quick one-liners — typo fixes, obvious small edits. Ideation is overhead here.
  • bugfix — bugs get root-cause investigation first via the debugger, not requirements clarification. The "what" is already defined (make the broken thing work).

If you find yourself asking questions whose answers you already have, stop — you're past the point this skill is for.

The process

Keep it lightweight. The value is a locked scope, not ceremony.

  1. Ask 3–5 clarifying questions, one at a time. One question per turn — each answer informs the next. Cover purpose (what problem does this solve, for whom), constraints (what must it fit within — existing patterns, platforms, non-negotiables), and success criteria (how do we know it's done and right).
  2. Prefer the minimal interpretation. When the request is open-ended, propose the smallest thing that satisfies it and confirm — don't quietly scope in an ambitious version. This is smallest-change-first applied to requirements: don't build features nobody asked for (YAGNI).
  3. Propose 2–3 approaches when there's a real design fork, each with its trade-off and your recommendation. Lead with the one you'd pick and say why.
  4. Confirm, then write the scope brief. Once the user agrees, produce the brief below — it becomes the planner's input.
Show full SKILL.md (152 more words)Show less

The scope brief

End by producing this block. It is the hand-off to the planner; keep it compact.

**Scope brief**
- Goal: <one sentence>
- In scope: <bullets>
- Out of scope: <bullets — the explicit "not doing" list>
- Key decisions: <choices made during ideation + why>
- Open questions: <anything still unresolved, or "none">

When routing through @orchestrator, pass this brief in the invocation so the planner receives it — a cold subagent can't see the conversation it wasn't part of.

Red flags

ThoughtReality
"I get the gist, I'll just start coding"A gist is not an agreed scope. Confirm the what first.
"I'll ask all my questions at once"One at a time — each answer changes what you'd ask next.
"The request was vague, so I'll pick something ambitious"Pick the minimal interpretation and confirm it. Scope creep starts here.
"This feature is obviously simple, skip the brief"Simple-looking features are where unexamined assumptions cost the most. The brief can be three lines, but write it.
"The out-of-scope list is empty"If nothing is out of scope, you haven't bounded anything. Name what you're deliberately not doing.

© ccplugins, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/craftsman/skills/ideation-first of ccplugins/awesome-claude-code-plugins.

Open the folder on GitHubat commit 5bd4f16

Compare with similar skills

Ideation First next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ideation First compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ideation First this skillccplugins/awesome-claude-code-plugins968—~926Automated safety check: PassApache-2.0
Cc10x Routerromiluz13/cc10x164—~20kAutomated safety check: PassMIT
BrainstormingJetBrains/thinkrail513—~913Automated safety check: PassApache-2.0
Odoo Workflowunclecatvn/agent-skills143—~4.7kAutomated safety check: PassMIT
Brainstormingxpinjection/test-driven-spring-boot11254 repos~2.6kAutomated safety check: PassMIT
Auto Skill Buildertradecatlabs/vibe-coding-cn17k1 repos~2.4kAutomated safety check: PassMIT

Similar skills

  • Cc10x Router

    romiluz13/cc10x

    Routes build, debug, review, plan, QA, and triage requests through the cc10x workflows (task graphs, workflow artifacts, gates); it is the single entry point for cc10x code work.

    164 GitHub stars~20k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Brainstorming

    JetBrains/thinkrail

    Official

    Use before implementation when a request requires choosing product scope, user-visible behavior, or architecture.

    513 GitHub stars~913 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Odoo Workflow

    unclecatvn/agent-skills

    Mandatory pre-code gate and definition-of-done for ANY Odoo change (add field, override method, inherit view/xpath, OWL/JS patch, wizard, cron, controller, report, security, migration, bug fix…

    143 GitHub stars~4.7k tokensUpdated 14 days ago
    DevelopmentAuto-check passed
  • Brainstorming

    xpinjection/test-driven-spring-boot

    You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior.

    112 GitHub starsUsed in 54 repos~2.6k tokens
    Agent WorkflowsAuto-check passed
  • Auto Skill Builder

    tradecatlabs/vibe-coding-cn

    Meta-skill that turns docs, APIs, code or specs into a reusable skill with references and a quality gate, and refactors skills that are unclear or misfire.

    17k GitHub starsUsed in 1 repo~2.4k tokens
    Agent WorkflowsAuto-check passed
  • LLM Council

    gcpdev/llm-council-skill

    Multi-LLM collaborative brainstorming and planning. An agent skill from gcpdev/llm-council-skill.

    461 GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check: notes

More from ccplugins/awesome-claude-code-plugins

All 66 skills in this repo
  • AI Meeting

    ccplugins/awesome-claude-code-plugins

    Run structured AI meetings for plans, product ideas, technical designs, business decisions, feature proposals, and strategy choices.

    968 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check: notes
  • Fastapi App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new FastAPI backend with async SQLAlchemy 2.0, asyncpg, Alembic, Pydantic v2, and no deprecated APIs.

    968 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Flutter App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Flutter mobile app with clean architecture, Riverpod, FVM-pinned SDK, current packages, and no deprecated APIs.

    968 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Nextjs App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Next.js (App Router, TypeScript) web app with current packages and no deprecated APIs.

    968 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Dev Report

    ccplugins/awesome-claude-code-plugins

    Write up a coding session for a non-technical stakeholder — the context, what was built, and the engineering reasoning behind it — the way a senior engineer briefs a product manager who does not…

    968 GitHub stars~3.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Difesa Attacchi

    ccplugins/awesome-claude-code-plugins

    Aggiunge a un sito/app un agente di difesa che rileva e blocca richieste malevole (SQL injection, XSS, path traversal, brute force, bot) con rate limiting, blocklist IP e modalità lockdown che…

    968 GitHub stars~781 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Ideation First

What does Ideation First do?

Use before planning a new feature or greenfield refactor whose requirements aren't yet pinned down — clarifies intent through a few questions and ends with a short scope brief the planner can build…. Ideation First is an agent skill from ccplugins/awesome-claude-code-plugins. Use before planning a new feature or greenfield refactor whose requirements aren't yet pinned down — clarifies intent through a few questions and ends with a short scope brief the planner can build on.

When should I use Ideation First?

Ideation First fits situations like: tasks that involve Brainstorming; tasks that involve Refactoring.

How do I install Ideation First in Claude Code?

Run `npx skills add ccplugins/awesome-claude-code-plugins --skill ideation-first -a claude-code`. Or copy the skill folder (plugins/craftsman/skills/ideation-first in ccplugins/awesome-claude-code-plugins) into .claude/skills/ideation-first in your project. Claude Code loads it when a task matches its description.

How do I install Ideation First in Codex?

Run `npx skills add ccplugins/awesome-claude-code-plugins --skill ideation-first -a codex`. Or copy the skill folder (plugins/craftsman/skills/ideation-first in ccplugins/awesome-claude-code-plugins) into .agents/skills/ideation-first in your project. Codex loads it when a task matches its description.

Can I use Ideation First in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ccplugins/awesome-claude-code-plugins --skill ideation-first -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ideation-first, .gemini/skills/ideation-first, .github/skills/ideation-first and .opencode/skills/ideation-first in your project.

What does Ideation First need to run?

SKILL.md names no scripts, command-line tools or credentials: Ideation First is instructions for the agent only.

Does Ideation First access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ideation First safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ideation First use?

Ideation First is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ideation First use?

About 926 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ideation First?

Skills that share tags, products or a category with Ideation First: Cc10x Router (romiluz13/cc10x, 164 stars), Brainstorming (JetBrains/thinkrail, 513 stars), Odoo Workflow (unclecatvn/agent-skills, 143 stars) and Brainstorming (xpinjection/test-driven-spring-boot, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ideation First?

ccplugins (a GitHub organization) maintains it in ccplugins/awesome-claude-code-plugins, which has 968 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on August 12, 2026.

Source: ccplugins/awesome-claude-code-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.