Agent skill

Project Cairn

by iBlinkQ in iBlinkQ/project-cairn

Standardize how an AI-collaboration project turns work into reusable knowledge.

MITAuto-check passedKnowledge Management

Install Project Cairn

skills CLI
$ npx skills add iBlinkQ/project-cairn --skill project-cairn -a claude-code

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

GitHub CLI
$ gh skill install iBlinkQ/project-cairn project-cairn --agent claude-code

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

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

Facts

Skill name
project-cairn
GitHub stars
235
Used in
2 other repos
Token cost
~861 tokens
SKILL.md length
355 words
Files
51 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Standardize how an AI-collaboration project turns work into reusable knowledge.

  • Retrofitting Project Cairn in a project
  • SKILL.md covers Routing, Templates and Boundaries
  • Recording progress after meaningful work
  • Maintaining AGENTS/CLAUDE/cairn docs

What it does

Project Cairn is an agent skill from iBlinkQ/project-cairn. Standardize how an AI-collaboration project turns work into reusable knowledge. Use when initializing or retrofitting Project Cairn in a project, recording progress after meaningful work, maintaining AGENTS/CLAUDE/cairn docs, auditing project knowledge for drift or missing records, pulling and citing external knowledge, or graduating validated project experience into a reusable knowledge base.

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. The skill folder holds 56 other files, including scripts, reference files and assets (for example `README.md`, `README.zh-CN.md` and `agents/openai.yaml`).

It sits in Knowledge Management, covering Knowledge bases. The repository describes itself as: Turn project work into reusable knowledge — an AI-agent skill for Claude Code & Codex. The licence is MIT.

When your agent uses it

  • Retrofitting Project Cairn in a project
  • Recording progress after meaningful work
  • Maintaining AGENTS/CLAUDE/cairn docs
  • Auditing project knowledge for drift

Example prompts

  • “/project-cairn”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 96ed344. 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 1 file in scripts/, which the agent can run.

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

  • Network

    No URLs in SKILL.md.

    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 Cairn loads about 861 tokens when it runs, and up to ~24k if it reads all its reference files. Until then it costs about 103 tokens; SKILL.md has 355 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from iBlinkQ/project-cairn at commit 96ed344, republished under its MIT licence (© iBlinkQ). 355 words, ~861 tokens.

Download SKILL.mdSave it as .claude/skills/project-cairn/SKILL.md (or your agent's skills folder). This skill also uses 50 other files; get the full folder from GitHub.
name
project-cairn
description
Standardize how an AI-collaboration project turns work into reusable knowledge. Use when initializing or retrofitting Project Cairn in a project, recording progress after meaningful work, maintaining AGENTS/CLAUDE/cairn docs, auditing project knowledge for drift or missing records, pulling and citing external knowledge, or graduating validated project experience into a reusable knowledge base.

Project Cairn

Project Cairn gives AI-collaboration projects a durable way to keep and reuse what they learn while doing real work. The Skill supplies the method, AGENTS.md carries always-read project rules, and .cairn/config.yaml stores machine-readable configuration.

This Skill is documentation-first. It provides instructions, templates, references, and provider adapters. It has no CLI, MCP server, background hook, chat-end trigger, automatic provider write, or automatic history migration. Routine maintenance happens during normal work because AGENTS.md carries the rules. Provider writes require human confirmation.

Routing

Load exactly the reference you need:

  • references/init.md — initialize, retrofit, bootstrap, or set up Project Cairn in a project.
  • references/consume.md — pull, cite, reuse, or apply external knowledge from the configured knowledge base.
  • references/maintenance.md — record progress, update LOG, update ROADMAP, maintain topic notes, or apply Cairn rules after work.
  • references/audit.md — inspect, audit, validate, clean up, or find missing project knowledge records.
  • references/upgrade.md — upgrade an initialized project instance to the current skill spec, or check how far it has drifted (instance drift after the skill itself evolved).
  • references/graduation.md — graduate knowledge, move reusable experience to a knowledge base, or judge graduation-readiness; a provider write additionally reads only the selected references/graduation/<provider>.md.
  • references/frontmatter.md — create or review Cairn topic notes or knowledge-base notes.
  • references/branch-closure.md — review, close, abandon, or roll back an exploration branch and salvage its cairn/ knowledge before it disappears.
  • references/zh-glossary.md — writing project docs in Chinese (or resolving what a Chinese term should be); fixed English↔Chinese terminology mapping for Project Cairn's own vocabulary.

Frontmatter describes triggers, not workflow.

Show full SKILL.md (111 more words)Show less

Templates

assets/templates/ contains AGENTS.md, CLAUDE.md, config.yaml, user-config.yaml, LOG.md, ROADMAP.md, topic.md, and Cited.md. init scaffolds AGENTS.md, CLAUDE.md, .cairn/config.yaml, cairn/LOG.md, and optional cairn/ROADMAP.md; it can seed optional ~/.config/cairn/config.yaml from user-config.yaml. topic.md, Cited.md, and Reference/ are trigger-created. Templates use {{PLACEHOLDER}} tokens; never hardcode a provider or knowledge path.

Boundaries

  • No background hook and no chat-end trigger are assumed.
  • Day-to-day maintenance happens because AGENTS.md is read as project rules.
  • Audit is the safety net for missed records.
  • Graduation is candidate detection plus human confirmation.
  • Historical migration is optional and separate from init.
  • scripts/*.sh use bash (verified on macOS/Linux; Windows needs WSL or Git Bash). scripts/*.py use Python 3 without a shell; notion-graduate-batch.py also needs PyYAML.

© iBlinkQ, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 50 other files (scripts, references, assets) in the repository root of iBlinkQ/project-cairn.

  • SKILL.md
  • LICENSE
  • README.md
  • README.zh-CN.md
  • agents/openai.yaml
  • assets/templates/AGENTS.md
  • assets/templates/CLAUDE.md
  • assets/templates/Cited.md
  • assets/templates/LOG.md
  • assets/templates/ROADMAP.md
  • assets/templates/config.yaml
  • assets/templates/topic.md
  • assets/templates/user-config.yaml
  • docs/assets/favicon/apple-touch-icon.png
  • docs/assets/favicon/favicon.ico
  • … and 36 more

Open the folder on GitHubat commit 96ed344

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in iBlinkQ/project-cairn, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Project Cairn 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 Cairn compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Cairn this skilliBlinkQ/project-cairn2352 repos~861Automated safety check: PassMIT
Capture Conversationoutline/outline41k—~474Automated safety check: PassCustom licence
LLM Wiki Knowledge GraphEgonex-AI/Understand-Anything86k1 repos~1.5kAutomated safety check: PassMIT
Find And Citeoutline/outline41k—~537Automated safety check: PassCustom licence
Xhs Virtual Productchenjin-cmd/xhs-virtual-product727—~862Automated safety check: PassMIT
OpenkbVectifyAI/OpenKB4.7k1 repos~2kAutomated safety check: WarnApache-2.0

Similar skills

  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • LLM Wiki Knowledge Graph

    Egonex-AI/Understand-Anything

    Detects a Karpathy-pattern LLM wiki and builds an interactive knowledge graph with entities, implicit relationships and topic clusters.

    86k GitHub starsUsed in 1 repo~1.5k tokens
    Knowledge ManagementAuto-check passed
  • Find And Cite

    outline/outline

    Answer questions from the Outline knowledge base with quotes and links to the source documents; use when the user asks what the team knows, documented, or decided about a topic.

    41k GitHub stars~537 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Xhs Virtual Product

    chenjin-cmd/xhs-virtual-product

    This skill helps plan, select, produce, and market Xiaohongshu (RED) virtual/digital products — templates, knowledge bases, test tools, study materials.

    727 GitHub stars~862 tokensUpdated 8 days ago
    Knowledge ManagementAuto-check passed
  • Openkb

    VectifyAI/OpenKB

    A skill your agent uses when the user asks about content in their OpenKB knowledge base — research topics, concepts compiled from their documents, cross-document synthesis — or mentions openkb, an…

    4.7k GitHub starsUsed in 1 repo~2k tokens
    Knowledge ManagementAuto-check: warnings
  • Learn From Materials

    dmoshehun-prog/learn-from-materials

    Turns books, PDFs, slides and web pages into a source-grounded knowledge base and an interactive learning page in English or Chinese, with quizzes, relationship maps and reusable methodology notes.

    916 GitHub stars~7.9k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed

Questions about Project Cairn

What does Project Cairn do?

Standardize how an AI-collaboration project turns work into reusable knowledge. Project Cairn is an agent skill from iBlinkQ/project-cairn. Standardize how an AI-collaboration project turns work into reusable knowledge.

When should I use Project Cairn?

Project Cairn fits situations like: retrofitting Project Cairn in a project; recording progress after meaningful work; maintaining AGENTS/CLAUDE/cairn docs; auditing project knowledge for drift.

How do I install Project Cairn in Claude Code?

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

How do I install Project Cairn in Codex?

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

Can I use Project Cairn 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 iBlinkQ/project-cairn --skill project-cairn -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-cairn, .gemini/skills/project-cairn, .github/skills/project-cairn and .opencode/skills/project-cairn in your project.

What does Project Cairn need to run?

SKILL.md names no scripts, command-line tools or credentials: Project Cairn is instructions for the agent only. Our summary lists: Python 3.

Does Project Cairn access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Project Cairn safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. 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 Cairn use?

Project Cairn is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Cairn use?

About 861 tokens (SKILL.md is roughly 3.4k 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 24k tokens, read only when the agent opens those files.

What are the alternatives to Project Cairn?

Skills that share tags, products or a category with Project Cairn: Capture Conversation (outline/outline, 41k stars), LLM Wiki Knowledge Graph (Egonex-AI/Understand-Anything, 86k stars), Find And Cite (outline/outline, 41k stars) and Xhs Virtual Product (chenjin-cmd/xhs-virtual-product, 727 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Cairn?

iBlinkQ (a GitHub user) maintains it in iBlinkQ/project-cairn, which has 235 GitHub stars. The repository was last updated on October 5, 2026.

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