ref-tracker

Automates logging of research sources and prompts to project documentation files.

1|Updated Nov 13, 2025
One-click install
npx skills add https://github.com/cadrianmae/claude-marketplace --skill ref-tracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ref-tracker
Source: https://github.com/cadrianmae/claude-marketplace/tree/main/plugins/ref-tracker/skills/ref-tracker
Command: npx skills add https://github.com/cadrianmae/claude-marketplace --skill ref-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually tracking research sources and prompts is time-consuming and prone to errors, leading to lost information and inefficient documentation. This skill automates that process, ensuring every piece of valuable context is captured without effort.

Core Features & Use Cases

  • Automatic Source Logging: Silently records all your web searches, web fetches, and local documentation lookups to CLAUDE_SOURCES.md.
  • Prompt Documentation: Automatically logs significant user prompts and their outcomes to CLAUDE_PROMPTS.md, building a comprehensive project history.
  • Use Case: As you research a complex topic or develop a new feature, this skill silently builds a comprehensive log of all your information sources and major decisions, ensuring you have a complete audit trail for reports, academic papers, or future reference.

Quick Start

Initialize reference tracking for this project. Then, as I work, automatically log all my web searches and major prompts.

Frequently Asked Questions about ref-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically track research sources during a project?

Automatic source tracking captures all web searches, web fetches, and documentation lookups to a CLAUDE_SOURCES.md file. Initialize with /track:init, and the Skill logs every source silently as you work, building a complete audit trail without manual effort.

Can I log prompts and decisions automatically alongside my research?

Yes. The Skill automatically documents significant prompts and outcomes to CLAUDE_PROMPTS.md alongside source tracking. This creates a parallel record of major decisions and reasoning tied to your research sources.

How do I set up reference tracking for a new project?

Issue /track:init to activate tracking for your project. The Skill checks a marker file for enabled status and reads a verbosity configuration. Once active, it silently appends sources and prompts; no additional setup is needed.

What happens if I already have CLAUDE_SOURCES.md or CLAUDE_PROMPTS.md files?

The Skill automatically detects existing CLAUDE_SOURCES.md and CLAUDE_PROMPTS.md files and resumes appending to them. Tracking activates without reinitializing, preserving your existing documentation.

Can I control how much tracking gets logged?

Yes. The Skill reads a verbosity configuration to decide logging detail. Logs are selective based on this setting; errors always surface, but routine tracking respects your configured verbosity level.