research

📁 smithery/ai 📅 8 days ago
2
总安装量
2
周安装量
#38179
全站排名
安装命令
npx skills add https://smithery.ai

Agent 安装分布

claude-code 2

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 markdown skill, operation 3)
  • Proper integration with existing research

Every write operation (create, import, move) MUST complete the full pipeline:

  1. Script — research.sh handles mechanical parts (move, rename, gh-links)
  2. Claude — YOU handle Claude-only parts (compact formatting via markdown skill)

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 markdown skill operation 3 — you’re the author)

  • Import existing file

    ~/.claude/skills/research/research.sh import <file> [topic]
    

    Script auto-enriches GH links. Then: invoke markdown skill 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