setup-references

Consolidate external project reference links into a documented references file.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/sizukutamago/claude-code-harness --skill setup-references
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-references
Source: https://github.com/sizukutamago/claude-code-harness/tree/main/.claude/skills/setup-references
Command: npx skills add https://github.com/sizukutamago/claude-code-harness --skill setup-references

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Projects scatter external links across issue trackers, design files, CI, and communication channels, making it hard to find authoritative sources; this skill consolidates those links into a single authoritative references file so teams can reliably locate correct URLs.

Core Features & Use Cases

  • Guided interactive hearing that collects categories such as Issue Tracker, Design, Documentation, Repository, Environments, CI/CD, Monitoring, Communication, and API Docs.
  • Detects and reads an existing docs/references.md, preserves current content, and updates or appends only the categories the user chooses; deletion requires human confirmation.
  • Use case: run during project onboarding or when integrating a new external service to create a single-source-of-truth for all external references.

Quick Start

Ask the assistant to collect the project's external reference links and write or update docs/references.md with the gathered information.

Frequently Asked Questions about setup-references

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

FAQPage Schema
How do I consolidate scattered project links into a single source of truth?

Consolidating scattered project links into a single source of truth involves collecting issue trackers, design files, and CI/CD endpoints into one documented references file. This skill guides an interactive hearing to gather external URLs and writes them to docs/references.md.

What is the best way to document external references during project onboarding?

Documenting external references during project onboarding is best handled by running a guided collection process for categories like environments, monitoring, and communication endpoints. The skill aggregates these inputs into a centralized references.md file for the team.

Can I update an existing references.md file without losing current content?

Updating an existing references.md file without losing content is supported by detecting and preserving current entries. The skill appends or updates only the categories you explicitly choose, and deletes nothing without human confirmation.

How do I collect metadata for issue trackers and Figma design files?

Collecting metadata for issue trackers and Figma design files is achieved through a guided interactive hearing that prompts you for relevant URLs. It categorizes these inputs alongside repositories, API docs, and communication channels into one file.

Does this project setup tool support periodic cleanup of documentation links?

Periodic cleanup of documentation links is supported during project setup or new service adoption. The skill reviews existing entries in your references file, allowing targeted updates and requiring explicit human confirmation before deleting any links.