Agent skill

Project References

by aiskillstore in aiskillstore/marketplace

Look up conventions, patterns, and concrete implementations from your own GitHub repositories checked out locally under ~/projects/referenzen/.

No licenceAuto-check: notesDevOps & Cloud

Install Project References

skills CLI
$ npx skills add aiskillstore/marketplace --skill project-references -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aiskillstore/marketplace project-references --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aiskillstore/marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dboeckli/project-references .claude/skills/project-references && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-references
GitHub stars
430
Token cost
~2.3k tokens
SKILL.md length
1,035 words
Files
6 (incl. scripts, references)
Skills in repo
1,108
Repo updated
First seen
Licence
None found

At a glance

Look up conventions, patterns, and concrete implementations from your own GitHub repositories checked out locally under ~/projects/referenzen/.

  • Works in 9 steps: Check whether the relevant repo is… → Ask the user which reference project is… → Search targeted — file first, then grep → …
  • There is uncertainty about how something is done in your codebase family — e.g
  • SKILL.md covers Instructions, Examples, Repository source and Scripts, plus 3 more sections
  • Runs Shell scripts from its folder; calls bash, git and gh

What it does

Project References is an agent skill from aiskillstore/marketplace. Look up conventions, patterns, and concrete implementations from your own GitHub repositories checked out locally under ~/projects/referenzen/. Use this skill whenever there is uncertainty about how something is done in your codebase family — e.g. Helm chart structure, Kubernetes manifests, framework configuration patterns, Docker Compose conventions, CI/CD pipeline setup, or any other recurring architectural decision. Invoke it proactively before guessing at a convention; always cite the source project and path…

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/search-patterns.md`, `scripts/clone-or-update.sh` and `scripts/list-workflow-triggers.sh`).

It sits in DevOps & Cloud, covering Container orchestration, CI/CD and Containers. It works with Helm, GitHub Actions, GitHub and Docker. The repository describes itself as: Security-audited skills for Claude, Codex & Claude Code. One-click install, quality verified.

When your agent uses it

  • There is uncertainty about how something is done in your codebase family — e.g
  • The user asks to check out
  • Search reference repositories
  • Generate an overview/report of GitHub Actions triggers (push

Example prompts

  • “/project-references”

Requirements

  • A Bash shell
  • Docker

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Check whether the relevant repo is already cloned
  2. Ask the user which reference project is most relevant
  3. Search targeted — file first, then grep
  4. Cite the source when adopting a pattern
  5. Sync only when explicitly requested
  6. Check out or update repositories
  7. Search within reference projects
  8. Discover available reference projects
  9. Overview of GitHub Actions triggers

What it can do on your machine

Read from SKILL.md and the folder at commit ad8daf7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • git
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project References loads about 2.3k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 191 tokens; SKILL.md has 1,035 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~191
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:241
    pository contents that contain secrets (`.env`, credential

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,035 words (~2,317 tokens).

“This skill manages a local mirror of your own GitHub repositories under ~/projects/referenzen/ and lets you look up conventions and implementation patterns without guessing or reading all repos blindly.”

— opening of SKILL.md by aiskillstore
name
project-references

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (scripts, references) in skills/dboeckli/project-references of aiskillstore/marketplace.

  • SKILL.md
  • references/search-patterns.md
  • scripts/clone-or-update.sh
  • scripts/list-workflow-triggers.sh
  • scripts/sync-all.sh
  • skill-report.json

Open the folder on GitHubat commit ad8daf7

Compare with similar skills

Project References next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project References compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project References this skillaiskillstore/marketplace430—~2.3kAutomated safety check: NotesNone
GitHub Runnermagnus919/agent-skills113—~1.7kAutomated safety check: PassMIT
Devops Automationrohitg00/awesome-claude-code-toolkit2.7k—~1.6kAutomated safety check: PassApache-2.0
Devops Excellencemajiayu000/spellbook286—~2.4kAutomated safety check: NotesMIT
Devops Deploymentyonatangross/orchestkit289—~2.7kAutomated safety check: PassMIT
Devops EngineerYikai-Liao/symusic1891 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • GitHub Runner

    magnus919/agent-skills

    Deploy, manage, and troubleshoot self-hosted GitHub Actions runners.

    113 GitHub stars~1.7k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Devops Automation

    rohitg00/awesome-claude-code-toolkit

    CI/CD pipeline design with GitHub Actions, Docker, Kubernetes, Helm, and GitOps patterns

    2.7k GitHub stars~1.6k tokensUpdated 4 mo ago
    DevOps & CloudAuto-check passed
  • Devops Excellence

    majiayu000/spellbook

    DevOps and CI/CD expert. An agent skill from majiayu000/spellbook.

    286 GitHub stars~2.4k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Devops Deployment

    yonatangross/orchestkit

    A skill your agent uses when setting up CI/CD pipelines, containerizing applications, deploying to Kubernetes, or writing infrastructure as code.

    289 GitHub stars~2.7k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Devops Engineer

    Yikai-Liao/symusic

    Creates Dockerfiles, configures CI/CD pipelines, writes Kubernetes manifests, and generates Terraform/Pulumi infrastructure templates.

    189 GitHub starsUsed in 1 repo~1.5k tokens
    DevOps & CloudAuto-check passed
  • Code Security

    semgrep/skills

    Official

    Security guidelines for writing secure code. An agent skill from semgrep/skills.

    322 GitHub stars~1.2k tokensUpdated 2 mo ago
    SecurityAuto-check passed

More from aiskillstore/marketplace

All 1,108 skills in this repo
  • Code Stats

    aiskillstore/marketplace

    Analyze codebase with tokei (fast line counts by language) and difft (semantic AST-aware diffs).

    430 GitHub starsUsed in 2 repos~697 tokens
    Auto-check: notes
  • File Search

    aiskillstore/marketplace

    Modern file and content search using fd, ripgrep (rg), and fzf.

    430 GitHub starsUsed in 2 repos~598 tokens
    Auto-check: notes
  • Data Processing

    aiskillstore/marketplace

    Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~720 tokens
    Auto-check: notes
  • Doc Scanner

    aiskillstore/marketplace

    Scans for project documentation files (AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, CURSOR.md, WARP.md, and 15+ other formats) and synthesizes guidance.

    430 GitHub starsUsed in 1 repo~644 tokens
    Auto-check: notes
  • Find Replace

    aiskillstore/marketplace

    Modern find-and-replace using sd (simpler than sed) and batch replacement patterns.

    430 GitHub starsUsed in 1 repo~527 tokens
    Auto-check: notes
  • Investigating Codebases

    aiskillstore/marketplace

    Automatically activated when user asks how something works, wants to understand unfamiliar code, needs to explore a new codebase, or asks questions like "where is X implemented?", "how does Y…

    430 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

Categories

Questions about Project References

What does Project References do?

Look up conventions, patterns, and concrete implementations from your own GitHub repositories checked out locally under ~/projects/referenzen/. Project References is an agent skill from aiskillstore/marketplace. Look up conventions, patterns, and concrete implementations from your own GitHub repositories checked out locally under ~/projects/referenzen/.

When should I use Project References?

Project References fits situations like: there is uncertainty about how something is done in your codebase family — e.g; the user asks to check out; search reference repositories; generate an overview/report of GitHub Actions triggers (push.

How do I install Project References in Claude Code?

Run `npx skills add aiskillstore/marketplace --skill project-references -a claude-code`. Or copy the skill folder (skills/dboeckli/project-references in aiskillstore/marketplace) into .claude/skills/project-references in your project. Claude Code loads it when a task matches its description.

How do I install Project References in Codex?

Run `npx skills add aiskillstore/marketplace --skill project-references -a codex`. Or copy the skill folder (skills/dboeckli/project-references in aiskillstore/marketplace) into .agents/skills/project-references in your project. Codex loads it when a task matches its description.

Can I use Project References in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aiskillstore/marketplace --skill project-references -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-references, .gemini/skills/project-references, .github/skills/project-references and .opencode/skills/project-references in your project.

What does Project References need to run?

Going by SKILL.md and its folder, Project References needs a shell for the scripts in its folder and the command-line tools its instructions call (bash, git and gh). Our summary lists: A Bash shell; Docker.

Does Project References access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Project References safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Project References use?

No licence was found for Project References or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Project References use?

About 2.3k tokens (SKILL.md is roughly 9.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 309 tokens, read only when the agent opens those files.

What are the alternatives to Project References?

Skills that share tags, products or a category with Project References: GitHub Runner (magnus919/agent-skills, 113 stars), Devops Automation (rohitg00/awesome-claude-code-toolkit, 2.7k stars), Devops Excellence (majiayu000/spellbook, 286 stars) and Devops Deployment (yonatangross/orchestkit, 289 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project References?

aiskillstore (a GitHub organization) maintains it in aiskillstore/marketplace, which has 430 GitHub stars. The repository holds 1,108 skills in this directory. The repository was last updated on October 7, 2026.

Source: aiskillstore/marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.