Agent skill
research-evaluate
Evaluate a research source from report_notes, understand its purpose, and create a Linear issue.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/research-evaluate
SKILL.md
Research Source Evaluator
Find a research source in report_notes/, analyze its content (purpose, tables, charts, key findings), and create a Linear issue for implementation.
Usage
# By source ID from research.csv
/research-evaluate RS-006
# By search query
/research-evaluate "mean reversion currencies"
# By file path
/research-evaluate report_notes/fx_seasonality_research/sources/quantpedia/002_mean_reversion_currencies.md
Workflow
Step 1: Find the Source
# If ID provided, look up in research.csv
grep "^$ID," /home/adesola/EpochDev/ClaudeCodeResearch/research.csv
# If query provided, search sources
grep -ri "$QUERY" /home/adesola/EpochDev/ClaudeCodeResearch/report_notes/*/sources/
Step 2: Read and Analyze the Source
Read the markdown file and extract:
- Frontmatter - URL, title, domain, crawl date
- Hypothesis - Main research question/thesis
- Data Requirements - Assets, timeframes, data sources needed
- Methodology - How the strategy/analysis works
- Key Metrics - Performance figures, statistics mentioned
- Charts/Tables - Visual elements and their purpose
# Example analysis structure
{
"source_id": "RS-006",
"title": "How to Build Mean Reversion Strategies in Currencies",
"url": "https://quantpedia.com/...",
"hypothesis": "Long undervalued and short overvalued currencies generates alpha",
"data_requirements": {
"assets": ["AD1", "BF1", "CD1", "EC1", "SF1", "JY1"],
"asset_type": "FX futures",
"timeframe": "daily",
"period": "2007-2024"
},
"methodology": {
"signal": "Deviation from average cumulative return",
"long": "Currencies below average (undervalued)",
"short": "Currencies above average (overvalued)",
"rebalancing": "Monthly",
"position_sizing": ["linear", "exponential"]
},
"key_metrics": {
"sharpe": 0.XX,
"annual_return": "X%",
"max_drawdown": "-X%"
},
"charts": [
{"name": "Cumulative returns", "purpose": "Shows mean reversion tendency"},
{"name": "Strategy performance", "purpose": "Backtest equity curve"}
],
"tables": [
{"name": "Position sizing comparison", "purpose": "Linear vs exponential results"}
]
}
Step 3: Check for Existing Issues
mcp__linear__linear_searchIssues(
query="$TITLE",
projectId="aedc87b9-3cee-4bdb-95ef-ac3d49e1218f", # Quantitative Research
limit=5
)
Step 4: Create Linear Issue
mcp__linear__linear_createIssue(
teamId="53f03fc6-d769-481a-b0f6-f7d6f8ab8085",
projectId="aedc87b9-3cee-4bdb-95ef-ac3d49e1218f", # Quantitative Research
priority=3,
title="Research: $TITLE",
description="""## Summary
$HYPOTHESIS
**Source:** [$TITLE]($URL)
**Source ID:** $SOURCE_ID
## Data Requirements
- **Assets:** $ASSETS
- **Timeframe:** $TIMEFRAME
- **Period:** $PERIOD
## Methodology
$METHODOLOGY_DESCRIPTION
## Key Findings from Source
$KEY_METRICS_AND_FINDINGS
## Charts to Reproduce
$CHARTS_LIST
## Tables to Reproduce
$TABLES_LIST
## Implementation Tasks
- [ ] Create research definition
- [ ] Configure data sources
- [ ] Implement signal generation
- [ ] Run study
- [ ] Analyze results
- [ ] Compare with source findings
## Reference
- Source file: `$FILE_PATH`
- Research CSV: `research.csv` row $SOURCE_ID
"""
)
Step 5: Update research.csv
Update the status and linear_issue columns:
# Change status from PENDING to TODO
# Add Linear issue ID
Output
After evaluation:
- Linear issue created with full analysis
- research.csv updated with issue link
- Summary printed showing:
- Source details
- Key hypothesis
- Data requirements
- Issue URL
Issue Description Template
## Summary
[1-2 sentence hypothesis from the research source]
**Source:** [Title](URL)
**Source ID:** RS-XXX
## Data Requirements
- **Assets:** [list assets]
- **Timeframe:** [daily/hourly/etc]
- **Period:** [date range]
## Methodology
[Description of how the strategy/analysis works]
## Key Findings from Source
| Metric | Value |
|--------|-------|
| Sharpe | X.XX |
| Annual Return | X% |
| Max Drawdown | -X% |
## Charts to Reproduce
1. [Chart name] - [purpose]
2. [Chart name] - [purpose]
## Tables to Reproduce
1. [Table name] - [purpose]
## Implementation Tasks
- [ ] Create research definition
- [ ] Configure data sources
- [ ] Implement signal generation
- [ ] Run study
- [ ] Analyze results
- [ ] Compare with source findings
## Reference
- Source file: `report_notes/.../file.md`
- Research CSV: `research.csv` row RS-XXX
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?