New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Choruz Archive Agent Notes

by inclusionAI in inclusionAI/Choruz

A skill your agent uses when adding, auditing, pruning, archiving, restoring, or reviewing Agent Notes in this repository; checks every new note for superseded active records, classifies implemented…

Apache-2.0Auto-check passedDevelopment

Install Choruz Archive Agent Notes

skills CLI
$ npx skills add inclusionAI/Choruz --skill choruz-archive-agent-notes -a claude-code

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

GitHub CLI
$ gh skill install inclusionAI/Choruz choruz-archive-agent-notes --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/inclusionAI/Choruz.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/choruz-archive-agent-notes .claude/skills/choruz-archive-agent-notes && 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
choruz-archive-agent-notes
GitHub stars
1k
Token cost
~1.2k tokens
SKILL.md length
573 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when adding, auditing, pruning, archiving, restoring, or reviewing Agent Notes in this repository; checks every new note for superseded active records, classifies implemented…

  • Works in 4 steps: git mv the file from implemented// to… → Insert only Archived: YYYY-MM-DD… → Search for inbound links from active… → …
  • Reviewing Agent Notes in this repository
  • SKILL.md covers Read the contracts, Check supersession when adding…, Classify by future value and Calibrated examples, plus 2 more sections
  • Calls git and python3

What it does

Choruz Archive Agent Notes is an agent skill from inclusionAI/Choruz. Use when adding, auditing, pruning, archiving, restoring, or reviewing Agent Notes in this repository; checks every new note for superseded active records, classifies implemented notes by future decision value, deletes rejected notes that no longer prevent a tempting mistake, and applies the frozen archived/{class} rules.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The licence is Apache-2.0.

When your agent uses it

  • Reviewing Agent Notes in this repository
  • Checks every new note for superseded active records
  • Classifies implemented notes by future decision value
  • Deletes rejected notes that no longer prevent a tempting mistake

Example prompts

  • “/choruz-archive-agent-notes”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. git mv the file from implemented// to archived//; implemented is deliberately absent from the archive path.
  2. Insert only Archived: YYYY-MM-DD immediately below Status: implemented. Make no other body edit: do not reformat, update facts, or repair…
  3. Search for inbound links from active prose (git grep -n ""). Redirect them to the current authority, retarget them to the archived path…
  4. Run python3 scripts/verify_agent_notes.py.

What it can do on your machine

Read from SKILL.md and the folder at commit 7509c40. 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

    Shell commands in SKILL.md call:

    • git
    • python3

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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

Choruz Archive Agent Notes loads about 1.2k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 573 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~88
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from inclusionAI/Choruz at commit 7509c40, republished under its Apache-2.0 licence (© inclusionAI). 573 words, ~1,173 tokens.

Download SKILL.mdSave it as .claude/skills/choruz-archive-agent-notes/SKILL.md (or your agent's skills folder).
name
choruz-archive-agent-notes
description
Use when adding, auditing, pruning, archiving, restoring, or reviewing Agent Notes in this repository; checks every new note for superseded active records, classifies implemented notes by future decision value, deletes rejected notes that no longer prevent a tempting mistake, and applies the frozen archived/{class} rules.

Archive Choruz Agent Notes

Reduce the active decision corpus without erasing history that can still guide work. Judge every note semantically; word count and age are discovery aids, never archive criteria.

Read the contracts

Read the Agent Note rules, the archive instructions and the implemented-folder instructions before classifying. Use current code, migrations, configuration, docs/, newer notes and inbound links to establish whether a rationale still owns or constrains anything.

Check supersession when adding a note

Every new Agent Note triggers a scoped audit of active notes covering the same decision, mechanism, or rejected alternative. Classify each full or partial supersession while writing the new note: archive qualifying implemented notes in the same PR, retain and cross-link partial supersessions or independently useful rationale, reject obsolete proposals, and delete rejected notes that no longer prevent a plausible mistake. Apply the consolidation rule in the README when the new owner absorbs every unique proposition; do not defer a known match to a later corpus audit.

Classify by future value

  • Implemented, keep active: retain a note when its rationale, alternatives, negative guarantees, wire or database semantics, ownership boundary, security rule, or reintroduction condition is likely to guide a future change. Length does not matter.
  • Implemented, archive: archive a note when the shipped decision is complete and its body is unlikely to guide future work: one-off UI chrome, a narrow adapter, a minor closed bug, superseded implementation detail, or process history whose current behaviour is obvious elsewhere.
  • Proposed, never archive: keep a live proposal active; if it is no longer worth pursuing, reject it with an honest reason on the Status: line.
  • Rejected, keep only as a guardrail: retain a rejection only when the losing proposal remains a tempting, meaningful mistake and the note explains why it loses.
  • Rejected, delete: delete the note when the rejected idea is obsolete, superseded, or unlikely to prevent re-litigation. Repair or delete inbound links.

Do not archive toward a quota. Inspect every note in scope, classify analogous groups under one principle, use best judgement for close cases, and record genuinely borderline decisions in the PR.

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

Calibrated examples

Archive implemented notes such as a closed sidebar-chrome tweak, a one-driver adapter detail whose current code is authoritative, or a completed migration checklist. Keep implemented notes such as workspace-scoped isolation (an ownership and security boundary) or per-turn roster injection (it states the negative guarantee that no team file exists). The four RFCs under archived/feature/ are the reference for what archival looks like: header block added, body untouched.

Archive one implemented note

  1. git mv the file from implemented/<class>/ to archived/<class>/; implemented is deliberately absent from the archive path.
  2. Insert only Archived: YYYY-MM-DD immediately below Status: implemented. Make no other body edit: do not reformat, update facts, or repair links inside the note.
  3. Search for inbound links from active prose (git grep -n "<filename>"). Redirect them to the current authority, retarget them to the archived path only when the historical snapshot is intentionally cited, or delete them.
  4. Run python3 scripts/verify_agent_notes.py.

After the move, never edit, move, or delete the note. Archived notes remain valid link targets but are historical snapshots, not authority for current behaviour.

Validate and report

Run python3 scripts/verify_agent_notes.py, python3 -m unittest discover scripts/tests, and git diff --check; select any additional evidence through choruz-pre-push-checks.

Report active implemented notes kept, implemented notes archived, rejected notes kept or deleted, proposed notes rejected if any, and every genuinely borderline case with its chosen outcome.

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

Files

Just SKILL.md in .agents/skills/choruz-archive-agent-notes of inclusionAI/Choruz.

Open the folder on GitHubat commit 7509c40

Compare with similar skills

Choruz Archive Agent Notes 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.

Choruz Archive Agent Notes compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Choruz Archive Agent Notes this skillinclusionAI/Choruz1k—~1.2kAutomated safety check: PassApache-2.0
Vercel Composition Patternssupabase/supabase111k58 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Vercel Composition Patterns

    supabase/supabase

    Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 58 repos~726 tokens
    DevelopmentAuto-check passed

  • Finishing a Development Branch

    obra/superpowers

    Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed

  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed

  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed

  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from inclusionAI/Choruz

All 11 skills in this repo

  • Choruz Merging Stacked PRs

    inclusionAI/Choruz

    A skill your agent uses when landing a chain of dependent pull requests (A ← B ← C, each based on the one below) onto main, merging a PR whose base is another open PR's branch, or whenever a request…

    1k GitHub stars~866 tokensUpdated 3 days ago
    Auto-check passed

  • Choruz CI Test Reliability

    inclusionAI/Choruz

    Design, review, and diagnose Choruz tests and fixtures that can fail nondeterministically under CI concurrency: parallel Playwright workers sharing one PostgreSQL and one API, vitest workers, cargo…

    1k GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed

  • Choruz Code Review

    inclusionAI/Choruz

    A skill your agent uses when reviewing a pull request in this repository; orients the reviewer to Choruz's standards (AGENTS.md conventions, the PR test policy, Agent Notes, the CI gates) and the…

    1k GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed

  • Choruz Doc

    inclusionAI/Choruz

    Create, restructure, review, audit, or migrate Choruz Markdown documentation (docs/, README, AGENTS.md, the in-app docs pages) using one owner per fact, tier placement, executed-operation…

    1k GitHub stars~1.6k tokensUpdated 3 days ago
    Auto-check passed

  • Choruz Find Simplifications

    inclusionAI/Choruz

    A skill your agent uses when working in this repository to find non-obvious simplification candidates, remove redundant comments or implementation-heavy documentation, write proposed Agent Notes or…

    1k GitHub stars~1.6k tokensUpdated 3 days ago
    Auto-check passed

  • Choruz PR

    inclusionAI/Choruz

    Use before opening or completing a pull request in this repository — classify the change, add the tests its type requires, run exactly what CI will run, label it, merge only on a green "CI (linux)…

    1k GitHub stars~2.6k tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Choruz Archive Agent Notes

What does Choruz Archive Agent Notes do?

A skill your agent uses when adding, auditing, pruning, archiving, restoring, or reviewing Agent Notes in this repository; checks every new note for superseded active records, classifies implemented…. Choruz Archive Agent Notes is an agent skill from inclusionAI/Choruz. Use when adding, auditing, pruning, archiving, restoring, or reviewing Agent Notes in this repository; checks every new note for superseded active records, classifies implemented notes by future decision value, deletes rejected notes that no longer prevent a tempting mistake, and applies the frozen archived/{class} rules.

When should I use Choruz Archive Agent Notes?

Choruz Archive Agent Notes fits situations like: reviewing Agent Notes in this repository; checks every new note for superseded active records; classifies implemented notes by future decision value; deletes rejected notes that no longer prevent a tempting mistake.

How do I install Choruz Archive Agent Notes in Claude Code?

Run `npx skills add inclusionAI/Choruz --skill choruz-archive-agent-notes -a claude-code`. Or copy the skill folder (.agents/skills/choruz-archive-agent-notes in inclusionAI/Choruz) into .claude/skills/choruz-archive-agent-notes in your project. Claude Code loads it when a task matches its description.

How do I install Choruz Archive Agent Notes in Codex?

Run `npx skills add inclusionAI/Choruz --skill choruz-archive-agent-notes -a codex`. Or copy the skill folder (.agents/skills/choruz-archive-agent-notes in inclusionAI/Choruz) into .agents/skills/choruz-archive-agent-notes in your project. Codex loads it when a task matches its description.

Can I use Choruz Archive Agent Notes 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 inclusionAI/Choruz --skill choruz-archive-agent-notes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/choruz-archive-agent-notes, .gemini/skills/choruz-archive-agent-notes, .github/skills/choruz-archive-agent-notes and .opencode/skills/choruz-archive-agent-notes in your project.

What does Choruz Archive Agent Notes need to run?

Going by SKILL.md and its folder, Choruz Archive Agent Notes needs the command-line tools its instructions call (git and python3). Our summary lists: Python 3.

Does Choruz Archive Agent Notes access the network?

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

Is Choruz Archive Agent Notes 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. Review the folder before installing.

What licence does Choruz Archive Agent Notes use?

Choruz Archive Agent Notes is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Choruz Archive Agent Notes use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Choruz Archive Agent Notes?

Skills that share tags, products or a category with Choruz Archive Agent Notes: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Choruz Archive Agent Notes?

inclusionAI (a GitHub organization) maintains it in inclusionAI/Choruz, which has 1,017 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 7, 2026.

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