Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 49 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,50 @@ A [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/

## What It Does

This skill walks non-technical community members through a **5-step conversational workflow**:
This skill supports **two modes** for non-technical community members:

1. **Describe & Search** β€” Capture the idea and search for similar concepts in the Intuition knowledge graph
### Mode A: Full Ideation (5 Steps)
Walk through the complete idea-to-publication pipeline:

1. **Describe & Search** β€” Capture the idea and search for similar concepts in **both** the Intuition knowledge graph (onchain) **and** GitHub
2. **Brainstorm & Draft** β€” Structure the idea into a standardized template through guided conversation
3. **Challenge** β€” Stress-test the idea from feasibility, market, protocol-fit, and UX angles
4. **Publish to GitHub** β€” Create a PR on the [intuition-box/ideas](https://github.com/intuition-box/ideas) repo
5. **Publish on Intuition** β€” Create an on-chain atom and claim via the Intuition Protocol
5. **Publish on Intuition** β€” Create an on-chain atom, link it to the curated ideas list, and stake on it

### Mode B: Smart Idea Discovery 🎲
Discover ideas from the **onchain Intuition ideas list** using three strategies:

- πŸ”₯ **Popular** β€” the most backed ideas, sorted by $TRUST staked
- πŸ’Ž **Hidden Gems** β€” ideas with community support but no recent activity (staleness-weighted rediscovery)
- πŸ“ˆ **Rising** β€” ideas gaining momentum, ranked by stakers-per-day growth rate
- 🎲 **Random** β€” pure surprise mode

All modes query the Intuition mainnet GraphQL API, compute momentum scores and activity age, and fall back to GitHub if onchain data is unavailable.

## What's New

### v2.2 β€” Configurable Intelligence (feedback from [@danielamodu](https://github.com/danielamodu))
- **πŸŽ›οΈ Configurable `dormancy_days`** β€” Hidden Gems threshold is now tunable (default: 14 days). Power users can set custom values for seasonal ideas (e.g., infrastructure ideas dormant 30+ days)
- **⏱️ Rising mode minimum age filter** β€” New `min_rising_age_days` parameter (default: 3 days) prevents brand-new ideas with 1 staker from falsely appearing as "rising"
- **🧠 Selection reasoning** β€” Each picked idea now includes a `SELECTION_REASON` explaining WHY it was chosen (e.g., "Gaining 2.45 stakers/day β€” fastest growing in the pool")
- **πŸ’¬ Interactive threshold prompt** β€” When entering Hidden Gems mode, the skill proactively asks the user if they want to adjust the dormancy window
- **πŸ“Š Enhanced output** β€” Presentations now show `DORMANCY_THRESHOLD` and `MIN_RISING_AGE` for full transparency

### v2.1 β€” Smart Discovery Modes
- **πŸ”₯ Popular / πŸ’Ž Hidden Gems / πŸ“ˆ Rising** β€” Three discovery strategies for the Random Idea Picker, each with tailored presentation
- **πŸ“Š Momentum scoring** β€” Computes stakers-per-day growth rate to identify rising ideas
- **⏰ Staleness-weighted rediscovery** β€” Surfaces ideas with community backing (positionCount > 0) but no activity for 14+ days
- **πŸ”„ Mode switching** β€” Users can switch between discovery modes mid-session
- **πŸ“ˆ Activity metrics** β€” Each idea now shows days since last activity and momentum score

### v2.0 β€” Onchain Integration
- **🎲 Random Idea Picker** β€” Pull random ideas from the onchain knowledge graph for inspiration
- **πŸ” Dual-state checking** β€” Search both GitHub AND onchain state before brainstorming to prevent duplicates
- **πŸ”— Onchain ideas list integration** β€” New ideas are automatically linked to the curated list via the `[Idea] β†’ [top project ideas for] β†’ [Intuition]` triple pattern
- **πŸ’° Streamlined publish flow** β€” Pre-flight cost checks, batch triple creation, deposit previews, and clear error recovery
- **πŸ›‘οΈ Duplicate prevention** β€” Automatically detects existing atoms and reuses them instead of creating duplicates
- **πŸ“Š Cost transparency** β€” Shows exact $TRUST costs upfront before any transaction

## Installation

Expand All @@ -37,12 +74,14 @@ Once installed, the skill triggers automatically when you say things like:
- *"Let's brainstorm a product concept"*
- *"I want to submit an idea to intuition-box"*
- *"New idea for the protocol"*
- *"Random idea"* / *"Inspire me"* / *"What should I build?"* / *"Pick an idea for me"*
- *"Show me hidden gems"* / *"What's trending?"* / *"Find forgotten ideas"*

## Skill Structure

```
.claude/skills/intuition-ideation/
β”œβ”€β”€ SKILL.md # Main skill definition
β”œβ”€β”€ SKILL.md # Main skill definition (v2.1 β€” smart discovery modes + onchain integration)
β”œβ”€β”€ assets/
β”‚ └── workflow-overview.png # Visual overview of the 5-step workflow
└── references/
Expand All @@ -56,10 +95,12 @@ Once installed, the skill triggers automatically when you say things like:

The skill bootstraps by loading the full [Intuition Protocol skill](https://github.com/0xIntuition/agent-skills/blob/main/skills/intuition/SKILL.md) as context, giving it deep knowledge of atoms, triples, vaults, GraphQL queries, ABI fragments, and network configuration. This enables it to:

- Search the Intuition knowledge graph for similar ideas (Step 1)
- Suggest realistic protocol integration patterns (Step 2)
- Evaluate feasibility against actual protocol capabilities (Step 3)
- Guide on-chain publishing with correct transaction parameters (Step 5)
- **Search** the Intuition knowledge graph for similar ideas (Step 1) β€” now checks both onchain AND GitHub
- **Discover** existing onchain ideas via the Random Idea Picker (Mode B)
- **Suggest** realistic protocol integration patterns (Step 2)
- **Evaluate** feasibility against actual protocol capabilities (Step 3)
- **Publish** with streamlined pre-flight checks, batch triple creation, and cost previews (Step 5)
- **Link** new ideas to the curated onchain list for discoverability

All technical details are translated into plain English for non-technical users.

Expand Down
Loading