Agent skill

Idea Grooming

by grandamenium in grandamenium/cortextos

Pressure-test a captured idea against an objective rubric and write a structured analysis back into the source file.

MITAuto-check passedEducation

Install Idea Grooming

skills CLI
$ npx skills add grandamenium/cortextos --skill idea-grooming -a claude-code

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

GitHub CLI
$ gh skill install grandamenium/cortextos idea-grooming --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/grandamenium/cortextos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/idea-grooming .claude/skills/idea-grooming && 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
idea-grooming
GitHub stars
101
Token cost
~2k tokens
SKILL.md length
1,011 words
Files
1
Skills in repo
55
Repo updated
First seen
Licence
MIT

At a glance

Pressure-test a captured idea against an objective rubric and write a structured analysis back into the source file.

  • Works in 4 steps: Update frontmatter: status: groomed,… → Fill each section body in the rubric… → If verdict is pursue and 3+ work threads… → …
  • : a new idea drops into an Ideas/ inbox (manual
  • SKILL.md covers Inputs, Posture (read this every time), Section-by-section rubric and Promotion rule (single file →…, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Idea Grooming is an agent skill from grandamenium/cortextos. Pressure-test a captured idea against an objective rubric and write a structured analysis back into the source file. Use when: a new idea drops into an Ideas/ inbox (manual or cron-watched), or when re-grilling an existing groomed idea against fresh market data.

Its SKILL.md is about 2k 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 Education, covering Quizzes and assessments, Requirements gathering and Scheduled and recurring tasks. The licence is MIT.

When your agent uses it

  • : a new idea drops into an Ideas/ inbox (manual
  • Re-grilling an existing groomed idea against fresh market data

Example prompts

  • “/idea-grooming”

Workflow steps

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

  1. Update frontmatter: status: groomed, groomed: , fill originality_score, market_size, manual_burden, verdict, populate tags if useful
  2. Fill each section body in the rubric order above
  3. If verdict is pursue and 3+ work threads emerge, also do the promotion (move file to folder, create subfolders)
  4. Don't touch the ## Original capture section — that's the historical record

What it can do on your machine

Read from SKILL.md and the folder at commit 6f93838. 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 (its code samples are yaml).

    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

Idea Grooming loads about 2k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 1,011 words of instructions outside code blocks.

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

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 grandamenium/cortextos at commit 6f93838, republished under its MIT licence (© grandamenium). 1,011 words, ~1,984 tokens.

Download SKILL.mdSave it as .claude/skills/idea-grooming/SKILL.md (or your agent's skills folder).
name
idea-grooming
description
Pressure-test a captured idea against an objective rubric and write a structured analysis back into the source file. Use when: a new idea drops into an Ideas/ inbox (manual or cron-watched), or when re-grilling an existing groomed idea against fresh market data.

Idea Grooming

You evaluate captured ideas against a rubric and write the analysis back into the source file in place. The original capture stays at the top, untouched. Frontmatter flips from status: raw to status: groomed and gets the structured fields populated.

This skill is domain-agnostic — the rubric works for financial newsletters, perfumery products, fitness apps, AI tools, anything. Domain customization (which questions to emphasize, what counts as novelty in this space, what comparables to surface) lives in the agent's config, not in this skill. Read your config.json or domain-specific notes for that overlay.


Inputs

A markdown file at a path the operator provides (typically <vault>/Ideas/<idea>.md). The file follows the canonical template:

yaml
---
title: <one-line idea title>
status: raw
created: YYYY-MM-DD
groomed:
captured_by: <sam | quint | other>
tags: []
originality_score:
market_size:
manual_burden:
verdict:
folder_promoted: false
---

# <Title>

## Original capture
<verbatim source>

## Originality
*(empty — you fill)*

## Market potential
*(empty — you fill)*

## Moats
## Barriers
## Scaling vulnerabilities
## Manual burden
## Verdict

If a file you're asked to groom doesn't have the frontmatter shell, add it. Don't refuse the work just because the format is off.


Posture (read this every time)

  • Ground every claim in something concrete. "There's clearly demand" is not a claim. "Stratechery has 30k+ paid subs at $120/yr in this exact category" is.
  • Default to skepticism. Most ideas are average. Originality is rare; mark originality_score: 2 if that's the truth.
  • Surface disagreement. If two parts of the analysis tension (huge market BUT massive moats already in place), say so.
  • No flattery. If verdict is kill, write the kill reason cleanly. The whole point of grooming is sharper thinking, not validation.
  • Write the body in plain language. This is read by humans, not by other agents. No bureaucratese.

Section-by-section rubric

Originality (1-5)
  • 1 — exists at scale, undifferentiated copy
  • 2 — exists, this version has a small twist
  • 3 — meaningful differentiation in a crowded space
  • 4 — genuinely new angle in a known category
  • 5 — new category, no obvious comparable

Always name the closest 2-3 comparables explicitly. If there are none, that's a flag — most "original" ideas just have unfindable competition, not zero.

Market potential

Three reads:

  • Who buys/uses — name the persona, not "people who want X"
  • Demand signal — what's already paying for nearby goods? Search trends? Subreddit activity? Conference floor density?
  • Size band — small (<$10M TAM, lifestyle), mid ($10M–$1B, real business), large ($1B–$50B, venture-scale), massive ($50B+, generational)

Pick the band you can defend. If you'd cringe at a partner reading your defense, drop a band.

Moats

For each defensible advantage, mark it:

  • Data — proprietary data accumulating with use
  • Distribution — owned audience, established channel
  • Brand — recognized name worth a premium
  • Network — value increases with users
  • Switching cost — pain to leave, not just inertia
  • Regulatory — license/compliance barrier
  • Talent — rare skill concentrated here
  • IP — patents, copyright, trade secret

For each: load-bearing (would actually defend in a price war) or weak (sounds defensible, isn't). Don't list a moat if it's weak — say "no real moat" honestly.

Barriers

What would actually stop us from shipping v1?

  • Tech — does it exist, is it ours to build, do we have skills
  • Capital — burn rate to MVP
  • Distribution — how do customers find this
  • Regulation — license/compliance to operate
  • Talent — who has to be hired
  • Customer trust — does the audience believe a 2-person op can deliver

Rank by which would ACTUALLY stop us. Customer trust often beats tech.

Scaling vulnerabilities

What breaks between MVP and 10x / 100x / 1000x:

  • Manual-ops bottleneck (does someone have to touch every customer)
  • Unit economics (cost curve flat or flipping negative at scale)
  • Support burden (who answers tickets at 1k users)
  • Compliance scope (regulation tightens at audience size)
  • Vendor lock-in (Mailchimp limits, API rate limits, etc.)

For each: at what scale does this bite? Day 1, 100 users, 10k users?

Manual burden

Honest labor estimate:

  • low — <2 hr/week to operate at MVP scale
  • med — 2–15 hr/week
  • high — 15+ hr/week, requires a hire to scale

Be specific about WHERE the burden sits — content production, customer success, ops, content review. AI helps where it's actually generative; not where it's review/judgment.

Show full SKILL.md (389 more words)Show less
Verdict
  • pursue — passes on all dimensions OR strong enough on 2-3 to justify exploring deeper. Add 1-3 concrete next moves.
  • park — promising but blocked by timing, capital, or another priority. Add a "revisit when X" condition.
  • kill — fails core dimension (no moat AND no market AND no originality). Add the one-line kill reason.
  • needs-more — analysis genuinely can't conclude with available info. Add what to learn.

Promotion rule (single file → folder)

Promote a .md to a folder (<idea-name>/Index.md + Notes/ + References/ + Open Questions.md) when ALL true:

  • verdict: pursue
  • 3+ distinct work threads (e.g. tech build + brand work + customer dev + legal review)
  • The single-file structure is becoming hard to reason about

Set folder_promoted: true in frontmatter when you do this. Move the original file to become Index.md in the new folder.


Domain overlay (read agent config)

Before grooming, check your agent's config for domain-specific signals:

  • domains: [<list>] — what spaces this agent works in (financial, perfumery, fitness, ai-communities, etc.)
  • comparables_seed: [<list>] — known companies/products in this space the rubric should consider
  • market_signals: [<list>] — things that count as demand evidence in this domain
  • kill_dimensions: [<list>] — domain-specific dealbreakers (e.g. "regulated advice without a license" for financial)

If your agent has no domain config, run the rubric domain-agnostic and surface in the verdict that no domain context was loaded.


Output

You write the analysis back into the source file in place:

  1. Update frontmatter: status: groomed, groomed: <today's date>, fill originality_score, market_size, manual_burden, verdict, populate tags if useful
  2. Fill each section body in the rubric order above
  3. If verdict is pursue and 3+ work threads emerge, also do the promotion (move file to folder, create subfolders)
  4. Don't touch the ## Original capture section — that's the historical record

Confirm completion in the way your agent normally confirms work (Telegram message to operator, log entry, etc.).


Re-grilling (cron pattern)

When run on a schedule against existing status: groomed + verdict: pursue ideas:

  • Re-read the file
  • Check for fresh news/market shifts in the domain (use the business-news-monitor skill output if available)
  • If the original analysis still holds → update groomed date only
  • If something material has shifted (new competitor, regulation change, market shrinkage) → append a ## Re-grill <date> section noting the shift + impact on verdict
  • If verdict needs to change → update frontmatter + add the re-grill section explaining why

Don't rewrite the original analysis — append. The trail is part of the value.

© grandamenium, MIT. 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 skills/idea-grooming of grandamenium/cortextos.

Open the folder on GitHubat commit 6f93838

Compare with similar skills

Idea Grooming 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.

Idea Grooming compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Idea Grooming this skillgrandamenium/cortextos101—~2kAutomated safety check: PassMIT
Agent Launcher Orchestratoralirezarezvani/claude-skills28k—~1.3kAutomated safety check: PassMIT
TendrillableIvy-Interactive/Ivy-Tendril202—~2.3kAutomated safety check: PassCustom licence
Tinyplace Agenttinyhumansai/tiny.place138—~1.1kAutomated safety check: PassGPL-3.0-or-later
Executive Digestmgonto/executive-assistant-skills118—~2.6kAutomated safety check: NotesNone
Cohesivityaiskillstore/marketplace4332 repos~3.7kAutomated safety check: PassNone

Similar skills

  • Agent Launcher Orchestrator

    alirezarezvani/claude-skills

    A skill your agent uses when a user wants to build, launch, grade, or schedule a Claude Managed Agent (CMA) in their own Anthropic account — "build me an agent", "launch this as a managed agent"…

    28k GitHub stars~1.3k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Tendrillable

    Ivy-Interactive/Ivy-Tendril

    Find "Tendrillable" GitHub issues - open, recent, code-requiring issues that an agent can plan and one-shot WITHOUT asking clarifying questions, with high probability of success.

    202 GitHub stars~2.3k tokensUpdated 26 days ago
    EducationAuto-check passed
  • Tinyplace Agent

    tinyhumansai/tiny.place

    A skill your agent uses when an agent needs to join tiny.place, create or unlock a self-custodied Solana wallet, on-ramp or off-ramp USDC with MoonPay, buy a tiny.place @handle domain, publish an…

    138 GitHub stars~1.1k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Executive Digest

    mgonto/executive-assistant-skills

    Generate the daily executive digest — a single WhatsApp summary of everything needing attention: stalled scheduling, pending intros, unanswered emails, promised follow-ups, open Todoist tasks, and…

    118 GitHub stars~2.6k tokensUpdated 7 mo ago
    Productivity & AutomationAuto-check: notes
  • Cohesivity

    aiskillstore/marketplace

    Backend and infra for a project via Cohesivity (cohesivity.ai).

    433 GitHub starsUsed in 2 repos~3.7k tokens
    Productivity & AutomationAuto-check passed
  • Team Builder

    LeoYeAI/openclaw-master-skills

    Deploy a multi-agent SaaS growth team on OpenClaw with shared workspace, async inbox communication, cron-scheduled tasks, deep project code scanning (Deep Dive), and optional Telegram integration.

    2.2k GitHub stars~5.7k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed

More from grandamenium/cortextos

All 55 skills in this repo
  • Cortext Self Diagnosis

    grandamenium/cortextos

    Diagnose cortextOS itself when the framework misbehaves — an agent has gone silent or wedged, agents are crash-looping, Telegram or agent-to-agent messages are not arriving, crons did not fire, an…

    101 GitHub stars~3.7k tokensUpdated 18 days ago
    Auto-check passed
  • Activity Channel

    grandamenium/cortextos

    You have completed something significant and want the whole org — all agents and the user — to know about it.

    101 GitHub stars~624 tokensUpdated 18 days ago
    Auto-check passed
  • Agentcard Purchase

    grandamenium/cortextos

    You need to make a purchase on behalf of the user — buy a SaaS subscription, pay for an API, purchase a domain, or any transaction requiring a credit card.

    101 GitHub stars~1.1k tokensUpdated 18 days ago
    Auto-check passed
  • Claude To Codex Migration

    grandamenium/cortextos

    Migrate ANY cortextOS agent from the claude-code runtime to the live codex-app-server runtime.

    101 GitHub stars~12k tokensUpdated 18 days ago
    Auto-check: warnings
  • Bus Reference

    grandamenium/cortextos

    Complete cortextos bus CLI reference - all available commands with examples.

    101 GitHub stars~3.8k tokensUpdated 18 days ago
    Auto-check passed
  • Business News Monitor

    grandamenium/cortextos

    Daily cron-driven scan of news/forums/social in a domain to surface market shifts, new competitors, regulatory changes, and net-new opportunities.

    101 GitHub stars~1.3k tokensUpdated 18 days ago
    Auto-check passed

Questions about Idea Grooming

What does Idea Grooming do?

Pressure-test a captured idea against an objective rubric and write a structured analysis back into the source file. Idea Grooming is an agent skill from grandamenium/cortextos. Pressure-test a captured idea against an objective rubric and write a structured analysis back into the source file.

When should I use Idea Grooming?

Idea Grooming fits situations like: : a new idea drops into an Ideas/ inbox (manual; re-grilling an existing groomed idea against fresh market data.

How do I install Idea Grooming in Claude Code?

Run `npx skills add grandamenium/cortextos --skill idea-grooming -a claude-code`. Or copy the skill folder (skills/idea-grooming in grandamenium/cortextos) into .claude/skills/idea-grooming in your project. Claude Code loads it when a task matches its description.

How do I install Idea Grooming in Codex?

Run `npx skills add grandamenium/cortextos --skill idea-grooming -a codex`. Or copy the skill folder (skills/idea-grooming in grandamenium/cortextos) into .agents/skills/idea-grooming in your project. Codex loads it when a task matches its description.

Can I use Idea Grooming 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 grandamenium/cortextos --skill idea-grooming -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/idea-grooming, .gemini/skills/idea-grooming, .github/skills/idea-grooming and .opencode/skills/idea-grooming in your project.

What does Idea Grooming need to run?

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

Does Idea Grooming 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 Idea Grooming 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 Idea Grooming use?

Idea Grooming is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Idea Grooming use?

About 2k tokens (SKILL.md is roughly 7.9k 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 Idea Grooming?

Skills that share tags, products or a category with Idea Grooming: Agent Launcher Orchestrator (alirezarezvani/claude-skills, 28k stars), Tendrillable (Ivy-Interactive/Ivy-Tendril, 202 stars), Tinyplace Agent (tinyhumansai/tiny.place, 138 stars) and Executive Digest (mgonto/executive-assistant-skills, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Idea Grooming?

grandamenium (a GitHub user) maintains it in grandamenium/cortextos, which has 101 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on September 23, 2026.

Source: grandamenium/cortextos on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.