Agent skill

Sc Claude Md Improver

by kylesnowschwartz in kylesnowschwartz/SimpleClaude

Audit and improve project memory files (CLAUDE.md, AGENTS.md, .claude.local.md) — assess against a quality rubric, then apply additions and removals.

No licenceAuto-check passedAgent Workflows

Install Sc Claude Md Improver

skills CLI
$ npx skills add kylesnowschwartz/SimpleClaude --skill sc-claude-md-improver -a claude-code

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

GitHub CLI
$ gh skill install kylesnowschwartz/SimpleClaude sc-claude-md-improver --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/kylesnowschwartz/SimpleClaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/sc-skills/skills/sc-claude-md-improver .claude/skills/sc-claude-md-improver && 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
sc-claude-md-improver
GitHub stars
114
Token cost
~2.5k tokens
SKILL.md length
756 words
Files
4 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
None found

At a glance

Audit and improve project memory files (CLAUDE.md, AGENTS.md, .claude.local.md) — assess against a quality rubric, then apply additions and removals.

  • Works in 4 steps: Discovery → Quality Assessment → Audit Report Output → …
  • Update a memory file
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Check whether one is too long

What it does

Sc Claude Md Improver is an agent skill from kylesnowschwartz/SimpleClaude. Audit and improve project memory files (CLAUDE.md, AGENTS.md, .claude.local.md) — assess against a quality rubric, then apply additions and removals. This skill SHOULD be used when the user asks to audit, improve, edit, fix, tighten, rewrite, or update a memory file, or to check whether one is too long, stale, or bloated.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/quality-criteria.md`, `references/templates.md` and `references/update-guidelines.md`).

It sits in Agent Workflows, covering Agent instruction files, Agent memory and Quizzes and assessments. The repository describes itself as: Practical minimalism for AI assisted programming with Claude Code.

When your agent uses it

  • Update a memory file
  • Check whether one is too long

Example prompts

  • “/sc-claude-md-improver”

Requirements

  • Node.js

Workflow steps

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

  1. Discovery
  2. Quality Assessment
  3. Audit Report Output
  4. Targeted Updates

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and markdown).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • agents.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

Sc Claude Md Improver loads about 2.5k tokens when it runs, and up to ~6.5k if it reads all its reference files. Until then it costs about 86 tokens; SKILL.md has 756 words of instructions outside code blocks.

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

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

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

“Audit and improve project memory files — primarily CLAUDE.md, but also AGENTS.md where present. The discipline is removal as much as addition: Chroma's 2025 Context Rot study (18 frontier models including Claude Opus 4 / Sonnet 4) showed every model…”

— opening of SKILL.md by kylesnowschwartz
name
sc-claude-md-improver

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in plugins/sc-skills/skills/sc-claude-md-improver of kylesnowschwartz/SimpleClaude.

  • SKILL.md
  • references/quality-criteria.md
  • references/templates.md
  • references/update-guidelines.md

Open the folder on GitHubat commit 5224fc7

Compare with similar skills

Sc Claude Md Improver 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.

Sc Claude Md Improver compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sc Claude Md Improver this skillkylesnowschwartz/SimpleClaude114—~2.5kAutomated safety check: PassNone
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
SkillOpt Sleep Cyclemicrosoft/SkillOpt18k—~2.3kAutomated safety check: PassMIT
CLAUDE.md Improveranthropics/claude-plugins-official38k5 repos~1.5kAutomated safety check: PassApache-2.0
Harness Engineering10xChengTu/harness-engineering1021 repos~1kAutomated safety check: PassNone
Directional Promptingkingbootoshi/directional-prompting143—~2.3kAutomated safety check: PassMIT

Similar skills

  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed
  • SkillOpt Sleep Cycle

    microsoft/SkillOpt

    Official

    Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.

    18k GitHub stars~2.3k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • CLAUDE.md Improver

    anthropics/claude-plugins-official

    Official

    Finds every CLAUDE.md file in a repository, scores each against quality criteria, shows a report, then makes targeted updates after you approve.

    38k GitHub starsUsed in 5 repos~1.5k tokens
    Agent WorkflowsAuto-check passed
  • Harness Engineering

    10xChengTu/harness-engineering

    Set up and improve harness engineering (AGENTS.md, docs/, lint rules, eval systems, project-level prompt engineering) for AI-agent-friendly codebases.

    102 GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check passed
  • Directional Prompting

    kingbootoshi/directional-prompting

    Write prompts, system instructions, agent directives, slash commands, and skill descriptions using two stacked layers — outcome-first (define the destination, success criteria, stopping condition)…

    143 GitHub stars~2.3k tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Codebase Analyzer

    severity1/claude-code-auto-memory

    This skill should be used when the user asks to "initialize auto-memory", "create CLAUDE.md", "set up project memory", or runs the /auto-memory:init command.

    159 GitHub stars~1.5k tokensUpdated 5 mo ago
    Agent WorkflowsAuto-check passed

More from kylesnowschwartz/SimpleClaude

All 14 skills in this repo
  • Human Writing

    kylesnowschwartz/SimpleClaude

    MUST be used for any request to draft, write, compose, or reword text another person will read, including 'draft a message', 'draft a reply', 'draft a Slack message', 'write an email', 'draft a PR…

    114 GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Sc Gemini Imagegen

    kylesnowschwartz/SimpleClaude

    Generate and edit images using the Gemini API (Nano Banana).

    114 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Sc Hypothesize

    kylesnowschwartz/SimpleClaude

    A skill your agent uses when multiple plausible approaches must be generated, tested, and compared against constraints before the user chooses.

    114 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Sc Review And Refactor

    kylesnowschwartz/SimpleClaude

    Routes review and refactoring work to a named technique. An agent skill from kylesnowschwartz/SimpleClaude.

    114 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Sc Socratic

    kylesnowschwartz/SimpleClaude

    A skill your agent uses when the user is clarifying beliefs, assumptions, goals, or framing before committing to decision or plan.

    114 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Hud First

    kylesnowschwartz/SimpleClaude

    A skill your agent uses when designing AI features and the real opportunity may be perception support, not delegated conversational work.

    114 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Sc Claude Md Improver

What does Sc Claude Md Improver do?

Audit and improve project memory files (CLAUDE.md, AGENTS.md, .claude.local.md) — assess against a quality rubric, then apply additions and removals. Sc Claude Md Improver is an agent skill from kylesnowschwartz/SimpleClaude.md) — assess against a quality rubric, then apply additions and removals.

When should I use Sc Claude Md Improver?

Sc Claude Md Improver fits situations like: update a memory file; check whether one is too long.

How do I install Sc Claude Md Improver in Claude Code?

Run `npx skills add kylesnowschwartz/SimpleClaude --skill sc-claude-md-improver -a claude-code`. Or copy the skill folder (plugins/sc-skills/skills/sc-claude-md-improver in kylesnowschwartz/SimpleClaude) into .claude/skills/sc-claude-md-improver in your project. Claude Code loads it when a task matches its description.

How do I install Sc Claude Md Improver in Codex?

Run `npx skills add kylesnowschwartz/SimpleClaude --skill sc-claude-md-improver -a codex`. Or copy the skill folder (plugins/sc-skills/skills/sc-claude-md-improver in kylesnowschwartz/SimpleClaude) into .agents/skills/sc-claude-md-improver in your project. Codex loads it when a task matches its description.

Can I use Sc Claude Md Improver 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 kylesnowschwartz/SimpleClaude --skill sc-claude-md-improver -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sc-claude-md-improver, .gemini/skills/sc-claude-md-improver, .github/skills/sc-claude-md-improver and .opencode/skills/sc-claude-md-improver in your project.

What does Sc Claude Md Improver need to run?

SKILL.md names no scripts, command-line tools or credentials: Sc Claude Md Improver is instructions for the agent only. Our summary lists: Node.js.

Does Sc Claude Md Improver access the network?

SKILL.md names 1 domain. As links in the text: agents.md. This is read from the text; nothing was executed.

Is Sc Claude Md Improver 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 Sc Claude Md Improver use?

No licence was found for Sc Claude Md Improver or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Sc Claude Md Improver use?

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

What are the alternatives to Sc Claude Md Improver?

Skills that share tags, products or a category with Sc Claude Md Improver: Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars), SkillOpt Sleep Cycle (microsoft/SkillOpt, 18k stars), CLAUDE.md Improver (anthropics/claude-plugins-official, 38k stars) and Harness Engineering (10xChengTu/harness-engineering, 102 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sc Claude Md Improver?

kylesnowschwartz (a GitHub user) maintains it in kylesnowschwartz/SimpleClaude, which has 114 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 11, 2026.

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