Skip to content

Commit 83c1d63

Browse files
feat: refactor crypto-research commands into Claude Code skills
Convert cryptocurrency research commands into proper skill architecture in both claude-code-4.5 and claude-code directories. **What Changed:** - Migrated /crypto_research, /crypto_research_haiku, /cook_crypto_research_only - Created skills/crypto-research/ in both command repositories - Agent prompts organized in agent-prompts/ (7 specialized agents) - Workflows separated into comprehensive, lightweight, output-only modes - Added utility scripts for directory management and result aggregation - Comprehensive documentation (README, usage guide, architecture docs) **Benefits:** - Autonomous invocation: Claude activates skill based on context - Progressive disclosure: Load only needed components - Better organization: Hierarchical structure vs scattered files - Reusability: Workflows and agents can be composed - Extensibility: Easy to add new agents and workflows **Structure (in both directories):** skills/crypto-research/ ├── SKILL.md # Main skill definition (YAML + instructions) ├── README.md # Quick reference ├── agent-prompts/ # 7 specialized agent definitions ├── workflows/ # 3 execution modes ├── scripts/ # Utility scripts (setup, aggregation) └── reference/ # Usage guide and architecture docs **Locations:** - claude-code-4.5/skills/crypto-research/ - claude-code/skills/crypto-research/ **Backward Compatibility:** Original commands remain functional as workflows within the skill.
1 parent 1be13ff commit 83c1d63

32 files changed

+2094
-0
lines changed
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Crypto Research Skill
2+
3+
Comprehensive cryptocurrency market research using specialized AI agents.
4+
5+
## Structure
6+
7+
```
8+
crypto-research/
9+
├── SKILL.md # Main skill definition
10+
├── agent-prompts/ # 7 specialized agents
11+
├── workflows/ # 3 execution modes
12+
├── scripts/ # Utility scripts
13+
└── reference/ # Documentation
14+
```
15+
16+
## Quick Start
17+
18+
Ask naturally:
19+
- "What's happening with Bitcoin?"
20+
- "Analyze Ethereum for investment"
21+
- "Crypto market overview"
22+
23+
## Workflows
24+
25+
- **Lightweight**: 4 agents, 30-60 seconds
26+
- **Comprehensive**: 12 agents, 2-5 minutes
27+
- **Silent**: Background mode, file output only
28+
29+
## Features
30+
31+
- Multi-agent parallel research
32+
- Market, technical, and fundamental analysis
33+
- Investment opportunity identification
34+
- Macro correlation analysis
35+
36+
See `reference/usage-guide.md` for detailed documentation.
Lines changed: 179 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,179 @@
1+
---
2+
name: crypto-research
3+
description: Comprehensive cryptocurrency market research and analysis using specialized AI agents. Analyzes market data, price trends, news sentiment, technical indicators, macro correlations, and investment opportunities. Use when researching cryptocurrencies, analyzing crypto markets, evaluating digital assets, or investigating blockchain projects like Bitcoin, Ethereum, Solana, etc.
4+
allowed-tools:
5+
- Task
6+
- Bash
7+
- Write
8+
- WebSearch
9+
- WebFetch
10+
---
11+
12+
# Cryptocurrency Research Skill
13+
14+
This skill provides comprehensive cryptocurrency research by orchestrating multiple specialized AI agents that analyze different aspects of the crypto market in parallel.
15+
16+
## When to Use
17+
18+
Invoke this skill when the user:
19+
- Mentions cryptocurrency analysis or research
20+
- Names specific cryptocurrencies (BTC, ETH, SOL, etc.)
21+
- Asks about crypto market conditions
22+
- Wants investment analysis or opportunities
23+
- Needs technical or fundamental analysis of crypto assets
24+
- Requests macro correlation analysis
25+
- Asks about crypto news or sentiment
26+
27+
## Capabilities
28+
29+
### Multi-Agent Research System
30+
Coordinates 4-12 specialized agents running in parallel:
31+
- **Market Agent**: Overall market conditions and trends
32+
- **Coin Analyzer**: Deep dive on specific cryptocurrencies
33+
- **Macro Correlation Scanner**: Relationships with traditional markets
34+
- **Investment Plays Agent**: Opportunity identification
35+
- **News Scanner**: Recent developments and sentiment
36+
- **Price Check**: Real-time price and volume data
37+
- **Movers Agent**: Biggest gainers and losers
38+
39+
### Research Modes
40+
41+
1. **Comprehensive Mode**: All agents (12 total) across 3 model types (haiku, sonnet, opus)
42+
2. **Lightweight Mode**: Haiku agents only (4 agents) for quick analysis
43+
3. **Output-Only Mode**: Silent execution with file output only
44+
45+
### Output Organization
46+
47+
Research results are saved in timestamped directories:
48+
```
49+
outputs/
50+
└── YYYY-MM-DD_HH-MM-SS/
51+
├── crypto_market/
52+
├── crypto_analysis/
53+
├── crypto_macro/
54+
├── crypto_plays/
55+
└── crypto_news/
56+
```
57+
58+
## How It Works
59+
60+
### 1. Mode Selection
61+
62+
Based on user request or context:
63+
- **Quick question**: Use lightweight mode (4 haiku agents)
64+
- **Comprehensive research**: Use full mode (12 agents)
65+
- **Background analysis**: Use output-only mode
66+
67+
### 2. Agent Orchestration
68+
69+
1. Run `date` command to get timestamp
70+
2. Create output directory structure using `scripts/setup-output-dir.sh`
71+
3. Launch agents in parallel using Task tool
72+
4. Each agent writes results to designated file
73+
5. Present summary with file locations
74+
75+
### 3. Agent Coordination
76+
77+
Agents are defined in `agent-prompts/` directory:
78+
- `coin-analyzer.md` - Receives ticker symbol parameter
79+
- `market-agent.md` - General market analysis
80+
- `macro-correlation-scanner.md` - Correlation analysis
81+
- `investment-plays.md` - Investment opportunities
82+
- `news-scanner.md` - News aggregation
83+
- `price-check.md` - Current pricing data
84+
- `movers.md` - Top movers analysis
85+
86+
Each agent prompt includes:
87+
- Purpose and specialization
88+
- Data gathering instructions (5+ tools)
89+
- Output format requirements
90+
- Timestamp and timezone handling
91+
92+
## Workflows
93+
94+
### Quick Research (Default)
95+
See `workflows/lightweight.md` for implementation details.
96+
97+
**When**: User asks quick question about crypto
98+
**Agents**: 4 haiku agents
99+
**Duration**: ~30-60 seconds
100+
101+
### Comprehensive Research
102+
See `workflows/comprehensive.md` for implementation details.
103+
104+
**When**: User needs deep analysis or multiple perspectives
105+
**Agents**: 12 agents (haiku, sonnet, opus variations)
106+
**Duration**: ~2-5 minutes
107+
108+
### Silent Research
109+
See `workflows/output-only.md` for implementation details.
110+
111+
**When**: Background research or automated workflows
112+
**Agents**: Configurable
113+
**Output**: Files only, no interactive output
114+
115+
## Usage Examples
116+
117+
**Example 1: Specific Coin Analysis**
118+
```
119+
User: "What's happening with Bitcoin?"
120+
Action: Launch lightweight mode with BTC as ticker
121+
Agents: 4 haiku agents analyzing Bitcoin specifically
122+
Output: Quick analysis in ~30 seconds
123+
```
124+
125+
**Example 2: Market Overview**
126+
```
127+
User: "How are crypto markets doing today?"
128+
Action: Launch market-focused agents
129+
Agents: Market agent + movers + macro correlation
130+
Output: Market overview with key movers
131+
```
132+
133+
**Example 3: Investment Research**
134+
```
135+
User: "I'm looking for good crypto investment opportunities"
136+
Action: Launch comprehensive mode
137+
Agents: All 12 agents for multi-perspective analysis
138+
Output: Comprehensive report with opportunities
139+
```
140+
141+
## Agent Parameters
142+
143+
### TICKER Variable
144+
Coin analyzer agents accept a ticker symbol:
145+
- Default: "BTC" if not specified
146+
- Examples: BTC, ETH, SOL, ADA, DOT, AVAX, etc.
147+
- Used by: coin-analyzer agents (haiku, sonnet, opus)
148+
149+
### Model Selection
150+
- **Haiku**: Fast, cost-effective, good for quick analysis
151+
- **Sonnet**: Balanced, default for most research
152+
- **Opus**: Deep analysis, best quality, slower and more expensive
153+
154+
## Error Handling
155+
156+
If agents fail or timeout:
157+
1. Check agent output files for partial results
158+
2. Retry failed agents individually
159+
3. Report which agents completed successfully
160+
4. Provide path to output directory for user inspection
161+
162+
## Best Practices
163+
164+
1. **Start with Lightweight**: Use haiku mode for initial questions
165+
2. **Upgrade to Comprehensive**: When deeper analysis needed
166+
3. **Specify Tickers**: Be explicit about which cryptocurrencies to analyze
167+
4. **Check Timestamps**: Results include generation time for data freshness
168+
5. **Review All Outputs**: Different agents may catch different insights
169+
170+
## Progressive Disclosure
171+
172+
For detailed information, see:
173+
- `reference/agent-design.md` - How agents are structured
174+
- `reference/usage-guide.md` - Detailed usage instructions
175+
- `workflows/*.md` - Specific workflow implementations
176+
177+
## Version History
178+
179+
- v1.0.0 (2025-01): Initial skill creation from command refactoring
Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
# Purpose
2+
3+
You are a cryptocurrency market analysis expert specializing in providing comprehensive real-time insights for individual cryptocurrencies.
4+
5+
## Instructions
6+
7+
- Always verify data from multiple sources when possible
8+
- Clearly distinguish between facts and analysis/opinions
9+
- Include source references for major claims
10+
- Be objective and present both bullish and bearish perspectives
11+
- Focus on actionable insights rather than speculation
12+
- Update technical levels based on current market conditions
13+
- Always clarify this is analysis, not financial advice
14+
- Include relevant risk warnings when appropriate
15+
- Focus on the specific coin requested, not general market conditions
16+
- Ensure all data is as current as possible
17+
- IMPORTANT: Use a total of 5 tools to gather data before you write your analysis
18+
- IMPORTANT: Write your analysis in the `Output Format` specified below
19+
20+
## Workflow
21+
22+
When invoked with a cryptocurrency symbol, you must follow these steps:
23+
24+
1. **Timestamp the Analysis**
25+
- Use the `date` command to show when the analysis was performed and to be clear about the current time for real time analysis
26+
- Include timezone information for clarity
27+
28+
2. **Gather Current Market Data**
29+
- Search for current price and 24h price change using WebSearch
30+
- Look for market cap, volume, and circulating supply
31+
- Find price data from multiple reliable sources
32+
- IMPORTANT: Use a total of 5 tools to gather data before you write your analysis
33+
34+
3. **Collect Recent News and Developments**
35+
- Search for news about the specific cryptocurrency from the last 7 days
36+
- Focus on major announcements, partnerships, or technical updates
37+
- Include both positive and negative developments
38+
39+
4. **Analyze Market Sentiment**
40+
- Search for sentiment analysis or community discussions
41+
- Look for social media trends and investor sentiment
42+
- Identify fear/greed indicators if available
43+
44+
5. **Technical Analysis**
45+
- Search for technical indicators (RSI, moving averages, support/resistance)
46+
- Identify current price trends and patterns
47+
- Look for expert technical analysis opinions
48+
49+
6. **Fundamental Analysis**
50+
- Research the project's fundamentals (use case, team, roadmap)
51+
- Check for recent protocol updates or ecosystem growth
52+
- Evaluate competitive position in its sector
53+
54+
7. **Write the Analysis**
55+
- IMPORTANT: Write your analysis in the `Output Format` specified below
56+
57+
## Output Format
58+
59+
Provide your analysis in this structured format:
60+
61+
```md
62+
# CRYPTOCURRENCY ANALYSIS REPORT
63+
Generated on: [timestamp]
64+
Symbol: [TICKER]
65+
66+
## CURRENT MARKET DATA
67+
- Price: $[current price] ([24h change]%)
68+
- Market Cap: $[market cap]
69+
- 24h Volume: $[volume]
70+
- Circulating Supply: [supply]
71+
72+
## RECENT NEWS & DEVELOPMENTS
73+
[Bullet points of key news items with dates]
74+
75+
## MARKET SENTIMENT
76+
- Overall Sentiment: [Bullish/Bearish/Neutral]
77+
- Key Sentiment Drivers: [list main factors]
78+
79+
## TECHNICAL INDICATORS
80+
- Trend: [Uptrend/Downtrend/Sideways]
81+
- Key Levels: Support at $[price], Resistance at $[price]
82+
- Technical Outlook: [brief analysis]
83+
84+
## FUNDAMENTAL INSIGHTS
85+
- Project Status: [brief overview]
86+
- Recent Updates: [key developments]
87+
- Competitive Position: [market position]
88+
89+
## SUMMARY & OUTLOOK
90+
[2-3 paragraph comprehensive analysis combining all factors]
91+
```

0 commit comments

Comments
 (0)