research
npx skills add https://smithery.ai
Agent 安装分布
Skill 文档
Research
Level
Research files live in one of two locations:
| Level | Path | When |
|---|---|---|
| user | ~/.claude/research/ |
Default â general learnings, cross-project |
| project | .claude/research/ |
Only when user explicitly says “project level” |
Default is user level. Use --project flag to override:
# User level (default)
~/.claude/skills/research/research.sh new <topic>
# Project level (only when explicitly requested)
~/.claude/skills/research/research.sh --project new <topic>
Trigger phrases for project level: “project level”, “project research”, “in this project’s research” â anything else defaults to user level.
Write
Manage research files â creation, naming, archival.
CRITICAL
NEVER write directly to the research directory. All research file creation MUST go through this skill to ensure:
- Correct naming convention
- Compact formatting applied (via
markdownskill, operation 3) - Proper integration with existing research
Every write operation (create, import, move) MUST complete the full pipeline:
- Script â
research.shhandles mechanical parts (move, rename, gh-links) - Claude â YOU handle Claude-only parts (compact formatting via
markdownskill)
The script is NOT the complete solution. You are the orchestrator.
| Authorship | Operations | Compact formatting |
|---|---|---|
| Claude writes | flush, save, create | Apply inline (no preview) |
| External | import, move | Preview-iterate-apply pass |
Skipping compact formatting entirely is a failure.
Operations
-
Create new file
~/.claude/skills/research/research.sh new <topic>Then: write content in compact format directly (invoke
markdownskill operation 3 â you’re the author) -
Import existing file
~/.claude/skills/research/research.sh import <file> [topic]Script auto-enriches GH links. Then: invoke
markdownskill operation 3 with preview-iterate-apply (external content) -
Archive old files
~/.claude/skills/research/research.sh cleanup -
List files
~/.claude/skills/research/research.sh list -
Enrich GitHub links
~/.claude/skills/research/research.sh format-gh-links <target> # Targets: current, all, diff, all-including-old, <file>...
File Format
<YYYY-MM-DD>-<HHMM>-<topic>.md
- Date/time â UTC
- Topic â kebab-case
Notes
- All timestamps UTC (
date -u) - 30-day auto-archive keeps recent files manageable
Subcommands
- Prune â remove conversational artifacts, distill knowledge
- Format â enrich GH links, apply compact formatting
- Flush CC Thread â extract learnings before context loss