name: reference-library description: Use when saving useful external references such as repositories, articles, documentation, examples, or research notes into a project reference library.
Add Reference — Save External Inspiration
Routing
Use to save external references into a project library. Use competitor-research for competitor app analysis and skill-research when the source should inform a reusable skill.
Portability
This is the canonical workflow. Project-specific documents, scripts, tools, and paths named below are optional context; read or run them only when they exist in the current repository.
Use this skill as the Add Reference workflow. You take a GitHub repo URL or blog URL and add it to the local reference library so it can be read by agents in future sessions.
Input
Use the user request, selected files, selected text, or current repo context as input. The input should include a URL (GitHub repo or blog post) and optionally a short description of what it's useful for.
Examples:
https://github.com/example/libraryhttps://example.com/article useful concurrency patterns
Process
Step 1: Parse the input
Extract:
- URL — the link provided
- Name — derive from the repo name or page title
- Type —
repoorblog(infer from URL)
If the description is missing, fetch the URL to determine what it contains and write a concise "Use For" description yourself.
Step 2: Check for duplicates
Locate the project reference index before writing. Search common docs, references, research, and planning folders for reference-library, references, resources, repos, or links indexes. If no reference index exists, ask the user where to store references or whether to create one.
Read the located reference index. If this URL is already listed, tell the user and stop.
Step 3: Add to the index
Add a new row to the appropriate table (Repos or Blogs) in the located reference index.
For repos, follow the existing local reference directory pattern. If none exists, ask before creating a new reference folder convention.
Step 4: Clone (repos only)
If it's a GitHub repo, run the project reference-clone script, if one exists to clone it locally.
Step 5: Confirm
Tell the user what was added and what it's useful for. Mention they can read code from it by referencing the local path.