Agent skill

Cleanslate

by AlmanacCode in AlmanacCode/codealmanac

A skill your agent uses when the user asks to run or prepare the Almanac clean-slate workflow, uninstall all local codealmanac/Almanac CLI artifacts, or reset a machine to first-time Almanac install…

Apache-2.0Auto-check passedKnowledge Management

Install Cleanslate

skills CLI
$ npx skills add AlmanacCode/codealmanac --skill cleanslate -a claude-code

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

GitHub CLI
$ gh skill install AlmanacCode/codealmanac cleanslate --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/AlmanacCode/codealmanac.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cleanslate .claude/skills/cleanslate && 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
cleanslate
GitHub stars
997
Token cost
~877 tokens
SKILL.md length
378 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user asks to run or prepare the Almanac clean-slate workflow, uninstall all local codealmanac/Almanac CLI artifacts, or reset a machine to first-time Almanac install…

  • Works in 7 steps: Record the starting state → If any Almanac CLI command exists, run… → Remove npm/global installs and caches → …
  • The user asks to run
  • Calls npm
  • Prepare the Almanac clean-slate workflow

What it does

Cleanslate is an agent skill from AlmanacCode/codealmanac. Use when the user asks to run or prepare the Almanac clean-slate workflow, uninstall all local codealmanac/Almanac CLI artifacts, or reset a machine to first-time Almanac install state.

Its SKILL.md is about 880 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 Knowledge Management. It works with npm and TypeScript. The repository describes itself as: A codebase wiki for AI coding agents. Captures what the code can't say: decisions, flows, invariants, gotchas. The licence is Apache-2.0.

When your agent uses it

  • The user asks to run
  • Prepare the Almanac clean-slate workflow
  • Uninstall all local codealmanac/Almanac CLI artifacts
  • Reset a machine to first-time Almanac install state

Example prompts

  • “/cleanslate”

Requirements

  • Node.js

Workflow steps

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

  1. Record the starting state
  2. If any Almanac CLI command exists, run the product uninstaller first
  3. Remove npm/global installs and caches
  4. Remove Almanac home/config artifacts
  5. Clean editor hook settings safely
  6. Clean Claude imports safely
  7. Verify the clean slate

What it can do on your machine

Read from SKILL.md and the folder at commit 0f15350. 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:

    • npm

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

  • Network

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

Cleanslate loads about 877 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 378 words of instructions outside code blocks.

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

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 AlmanacCode/codealmanac at commit 0f15350, republished under its Apache-2.0 licence (© AlmanacCode). 378 words, ~877 tokens.

Download SKILL.mdSave it as .claude/skills/cleanslate/SKILL.md (or your agent's skills folder).
name
cleanslate
description
Use when the user asks to run or prepare the Almanac clean-slate workflow, uninstall all local codealmanac/Almanac CLI artifacts, or reset a machine to first-time Almanac install state.

Almanac Clean Slate

Reset this machine to a first-time Almanac user state, then report exactly what changed.

Goal: remove every installed or cached codealmanac/Almanac CLI artifact from this laptop without touching unrelated user files, unrelated npm packages, or foreign editor hooks.

Work from safest to most direct:

  1. Record the starting state:

    • command -v almanac alm codealmanac || true
    • npm list -g codealmanac --depth=0 || true
    • find ~/.npm/_npx -path '*/node_modules/codealmanac/package.json' -print 2>/dev/null || true
    • Check for ~/.almanac, ~/.claude/almanac.md, ~/.claude/almanac-reference.md, legacy ~/.claude/codealmanac*.md, ~/.claude/hooks/almanac-capture.sh, ~/.codex/hooks.json, and ~/.cursor/hooks.json.
  2. If any Almanac CLI command exists, run the product uninstaller first:

    • Prefer almanac uninstall --yes.
    • If almanac is missing but codealmanac exists, run codealmanac uninstall --yes.
    • If both fail, continue with manual cleanup.
  3. Remove npm/global installs and caches:

    • Run npm uninstall -g codealmanac || true.
    • Remove codealmanac package directories under all local nvm global roots if they still exist.
    • Remove global bin shims named almanac, alm, and codealmanac only when they point at a codealmanac install.
    • Remove each ~/.npm/_npx/<hash> directory whose node_modules/codealmanac/package.json exists.
  4. Remove Almanac home/config artifacts:

    • Remove ~/.almanac.
    • Remove ~/.claude/almanac.md, ~/.claude/almanac-reference.md, ~/.claude/codealmanac.md, and ~/.claude/codealmanac-reference.md.
    • Remove ~/.claude/hooks/almanac-capture.sh if it exists.
  5. Clean editor hook settings safely:

    • In ~/.claude/settings.json, remove only hook commands whose command path ends with almanac-capture.sh; preserve every foreign hook.
    • In ~/.codex/hooks.json, remove only hook commands whose command path ends with almanac-capture.sh; preserve every foreign hook.
    • In ~/.cursor/hooks.json, remove only hook commands whose command path ends with almanac-capture.sh; preserve every foreign hook.
    • If a hook container becomes empty after removing Almanac's command, remove that empty container/key.
  6. Clean Claude imports safely:

    • In ~/.claude/CLAUDE.md, remove lines that are exactly @~/.claude/almanac.md or @~/.claude/codealmanac.md, plus those same lines followed by spaces/tabs and annotations.
    • Preserve lines that merely mention those paths inside other prose.
    • If CLAUDE.md becomes empty after removing Almanac imports, remove it.
  7. Verify the clean slate:

    • hash -r || true
    • command -v almanac alm codealmanac || true
    • npm list -g codealmanac --depth=0 || true
    • find ~/.npm/_npx -path '*/node_modules/codealmanac/package.json' -print 2>/dev/null || true
    • Check that ~/.almanac, guide files, and almanac-capture.sh are gone.
    • Check that no hook command ending in almanac-capture.sh remains in Claude, Codex, or Cursor hook settings.
Show full SKILL.md (30 more words)Show less

Output:

  • Show the exact commands/actions you ran in order.
  • Mark each as removed, already absent, or skipped with the reason.
  • End with the remaining command -v and npm/global/npx verification output.

© AlmanacCode, 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/cleanslate of AlmanacCode/codealmanac.

Open the folder on GitHubat commit 0f15350

Compare with similar skills

Cleanslate 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.

Cleanslate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cleanslate this skillAlmanacCode/codealmanac997—~877Automated safety check: PassApache-2.0
Logseq Plugin SDKlogseq/logseq45k—~2.3kAutomated safety check: PassAGPL-3.0
Sage Wiki Integratexoai/sage-wiki620—~861Automated safety check: PassMIT
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
Install Anti-Slop Oxlint Rulesdmmulroy/anti-slop5.3k1 repos~2.2kAutomated safety check: PassMIT
Link Workspace Packagesnomcopter/react-mosaic4.8k6 repos~760Automated safety check: PassCustom licence

Similar skills

  • Logseq Plugin SDK

    logseq/logseq

    Build, debug, or review Logseq plugins with the @logseq/libs SDK (TypeScript/JavaScript, iframe/shadow sandboxed).

    45k GitHub stars~2.3k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Sage Wiki Integrate

    xoai/sage-wiki

    Pipeline skill that wires sage-wiki into an existing project — detects language, installs the client, runs a smoke test, and reports.

    620 GitHub stars~861 tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Installs, updates or migrates the vendored anti-slop Oxlint plugin in a repository, keeping local rule changes and the plugin's license and provenance files.

    5.3k GitHub starsUsed in 1 repo~2.2k tokens
    DevelopmentAuto-check passed
  • Link Workspace Packages

    nomcopter/react-mosaic

    Link workspace packages in monorepos (npm, yarn, pnpm, bun).

    4.8k GitHub starsUsed in 6 repos~760 tokens
    DevelopmentAuto-check passed
  • Run the tests that cover a change in the pnpm repository, in the Rust workspace (pnpm/, pnpr/) or the TypeScript CLI (pnpm11/), and recognize the cases where a scoped run passes without testing…

    37k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed

More from AlmanacCode/codealmanac

  • Deep Refactor Audit

    AlmanacCode/codealmanac

    A skill your agent uses when a user asks for a major architecture/refactor audit, codebase smell investigation, boundary critique, feature simplification review, vibe-coded or AI-generated code…

    997 GitHub stars~3.5k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Cleanslate

What does Cleanslate do?

A skill your agent uses when the user asks to run or prepare the Almanac clean-slate workflow, uninstall all local codealmanac/Almanac CLI artifacts, or reset a machine to first-time Almanac install…. Cleanslate is an agent skill from AlmanacCode/codealmanac. Use when the user asks to run or prepare the Almanac clean-slate workflow, uninstall all local codealmanac/Almanac CLI artifacts, or reset a machine to first-time Almanac install state.

When should I use Cleanslate?

Cleanslate fits situations like: the user asks to run; prepare the Almanac clean-slate workflow; uninstall all local codealmanac/Almanac CLI artifacts; reset a machine to first-time Almanac install state.

How do I install Cleanslate in Claude Code?

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

How do I install Cleanslate in Codex?

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

Can I use Cleanslate 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 AlmanacCode/codealmanac --skill cleanslate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cleanslate, .gemini/skills/cleanslate, .github/skills/cleanslate and .opencode/skills/cleanslate in your project.

What does Cleanslate need to run?

Going by SKILL.md and its folder, Cleanslate needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Cleanslate access the network?

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

Is Cleanslate 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 Cleanslate use?

Cleanslate 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 Cleanslate use?

About 877 tokens (SKILL.md is roughly 3.5k 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 Cleanslate?

Skills that share tags, products or a category with Cleanslate: Logseq Plugin SDK (logseq/logseq, 45k stars), Sage Wiki Integrate (xoai/sage-wiki, 620 stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars) and Install Anti-Slop Oxlint Rules (dmmulroy/anti-slop, 5.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cleanslate?

AlmanacCode (a GitHub organization) maintains it in AlmanacCode/codealmanac, which has 997 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on July 25, 2026.

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