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

Claude Improve Config

by anam-org in anam-org/metaxy

Self-reflect on the current session to identify mistakes and propose improvements to .claude configuration (CLAUDE.md, hooks, skills).

Apache-2.0Auto-check passedAgent Workflows

Install Claude Improve Config

skills CLI
$ npx skills add anam-org/metaxy --skill claude-improve-config -a claude-code

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

GitHub CLI
$ gh skill install anam-org/metaxy claude-improve-config --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/anam-org/metaxy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/claude-improve-config .claude/skills/claude-improve-config && 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
claude-improve-config
GitHub stars
124
Token cost
~1k tokens
SKILL.md length
360 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

Self-reflect on the current session to identify mistakes and propose improvements to .claude configuration (CLAUDE.md, hooks, skills).

  • Works in 4 steps: Analyze the Session → Categorize Issues → Propose Configuration Changes → …
  • Tasks that involve Agent instruction files
  • SKILL.md covers When to Use, Self-Reflection Process, Guidelines and Example Proposals, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Claude Improve Config is an agent skill from anam-org/metaxy. Self-reflect on the current session to identify mistakes and propose improvements to .claude configuration (CLAUDE.md, hooks, skills).

Its SKILL.md is about 1k 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 Agent Workflows, covering Agent instruction files. The repository describes itself as: Pluggable metadata management framework for versioned incremental multimodal data/ML pipelines. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Agent instruction files

Example prompts

  • “/claude-improve-config”

Workflow steps

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

  1. Analyze the Session
  2. Categorize Issues
  3. Propose Configuration Changes
  4. Format the Proposal

What it can do on your machine

Read from SKILL.md and the folder at commit 8337842. 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 markdown and json).

    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

Claude Improve Config loads about 1k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 360 words of instructions outside code blocks.

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

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 anam-org/metaxy at commit 8337842, republished under its Apache-2.0 licence (© anam-org). 360 words, ~1,003 tokens.

Download SKILL.mdSave it as .claude/skills/claude-improve-config/SKILL.md (or your agent's skills folder).
name
claude-improve-config
description
Self-reflect on the current session to identify mistakes and propose improvements to .claude configuration (CLAUDE.md, hooks, skills).

Claude Config Self-Improvement

Analyze the current session for errors, mistakes, or inefficiencies and propose improvements to the .claude configuration to prevent similar issues in the future.

When to Use

  • After a session with significant mistakes or rework
  • When you notice patterns that could be prevented with better configuration
  • When explicitly requested via /claude-improve-config
  • Automatically triggered by the SessionEnd hook

Self-Reflection Process

1. Analyze the Session

Review the conversation for:

  • Repeated mistakes: Same error made multiple times
  • Misunderstandings: User had to correct Claude's interpretation
  • Inefficient workflows: Better approaches discovered late in the session
  • Tool misuse: Wrong tool for the job, excessive tool calls
  • Missing context: Information that would have helped if in CLAUDE.md
  • Ignored instructions: Existing CLAUDE.md rules that were violated
2. Categorize Issues

Rate severity:

  • Critical: Caused significant rework or user frustration
  • Moderate: Caused delays or minor corrections needed
  • Minor: Slight inefficiency but didn't impact outcome

Only propose changes for critical or moderate issues.

3. Propose Configuration Changes

Changes can include:

CLAUDE.md Updates:

  • New guardrails or constraints
  • Clarified existing instructions
  • Project-specific patterns to follow

New Hooks:

  • PreToolUse hooks to prevent specific mistakes
  • PostToolUse hooks to validate outputs
  • Stop hooks to enforce checks before completion

New Skills:

  • Reusable knowledge for recurring tasks
  • Best practices for specific domains
4. Format the Proposal

Present proposals clearly:

markdown
## Session Reflection

### Issues Identified

1. **[Critical/Moderate]** Brief description of the issue
   - What happened: ...
   - Why it happened: ...
   - Impact: ...

### Proposed Changes

#### Change 1: [Type - CLAUDE.md/Hook/Skill]

**Rationale:** Why this change prevents the issue

**Implementation:**
[Show the exact changes to make]

#### Change 2: ...
Show full SKILL.md (147 more words)Show less

Guidelines

  • Only propose changes that are generalizable - don't add rules for one-off situations
  • Keep CLAUDE.md concise - prefer hooks for enforcement over verbose instructions
  • Test proposed hooks mentally - ensure they won't block legitimate workflows
  • Prefer minimal changes - one well-designed rule is better than many narrow ones
  • Consider false positives - hooks should not create friction for normal operations

Example Proposals

Example 1: Missing Test Verification

Issue: Claude claimed tests passed without running them.

Proposal: Add to CLAUDE.md:

markdown
**Test verification**: Never claim tests pass without showing actual test output. Always run `uv run pytest` with the specific test file before marking test-related tasks complete.
Example 2: Repeated Lint Failures

Issue: Code was submitted with lint errors multiple times.

Proposal: Add PostToolUse hook for Write/Edit:

json
{
  "matcher": "Write|Edit",
  "hooks": [
    {
      "type": "command",
      "command": "ruff check --select=E,F $TOOL_INPUT.file_path 2>/dev/null || true"
    }
  ]
}
Example 3: Wrong Branch for PR

Issue: PR was created against wrong base branch.

Proposal: Add to CLAUDE.md:

markdown
**Pull requests**: Always verify the target branch before creating a PR. For this project, PRs should target `main` unless explicitly specified otherwise.

Non-Examples (Do NOT Propose)

  • One-off mistakes that won't recur
  • User preference differences (not errors)
  • Issues already covered by existing configuration
  • Overly specific rules that won't generalize
  • Changes that would slow down normal workflows significantly

© anam-org, 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 .claude/skills/claude-improve-config of anam-org/metaxy.

Open the folder on GitHubat commit 8337842

Compare with similar skills

Claude Improve Config 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.

Claude Improve Config compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Improve Config this skillanam-org/metaxy124—~1kAutomated safety check: PassApache-2.0
Using Agent Skillsaddyosmani/agent-skills105k4 repos~2.4kAutomated safety check: PassMIT
Claude ReflectBayramAnnakov/claude-reflect1.8k2 repos~627Automated safety check: PassMIT
Writing For Agentsbestofjs/bestofjs3.1k20 repos~2.7kAutomated safety check: PassMIT
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~11kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Using Agent Skills

    addyosmani/agent-skills

    Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.

    105k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed

  • Claude Reflect

    BayramAnnakov/claude-reflect

    Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.

    1.8k GitHub starsUsed in 2 repos~627 tokens
    Agent WorkflowsAuto-check passed

  • Writing For Agents

    bestofjs/bestofjs

    Writing documents for agents. An agent skill from bestofjs/bestofjs.

    3.1k GitHub starsUsed in 20 repos~2.7k tokens
    Agent WorkflowsAuto-check passed

  • 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

  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~11k tokens
    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

More from anam-org/metaxy

All 8 skills in this repo

  • Metaxy

    anam-org/metaxy

    This skill should be used when the user asks to "define a feature", "create a BaseFeature class", "track feature versions", "set up metadata store", "field-level lineage", "FieldSpec", "FeatureDep"…

    124 GitHub stars~1.5k tokensUpdated 10 days ago
    Auto-check passed

  • Tach

    anam-org/metaxy

    This skill should be used when the user asks to "add a tach module", "configure tach layers", "define module boundaries", "set up interfaces", "run tach check", "check module boundaries", "tach…

    124 GitHub stars~1.2k tokensUpdated 10 days ago
    Auto-check passed

  • Docs Page Frontmatter

    anam-org/metaxy

    Write YAML front matter for documentation pages with appropriate titles and descriptions for social cards.

    124 GitHub stars~948 tokensUpdated 10 days ago
    Auto-check passed

  • Hypothesis

    anam-org/metaxy

    Use Hypothesis for property-based testing to automatically generate comprehensive test cases, find edge cases, and write more robust tests with minimal example shrinking.

    124 GitHub stars~1.7k tokensUpdated 10 days ago
    Auto-check passed

  • Narwhals

    anam-org/metaxy

    Effectively use Narwhals to write dataframe-agnostic code that works seamlessly across multiple Python dataframe libraries.

    124 GitHub stars~3.3k tokensUpdated 10 days ago
    Auto-check passed

  • Sybil

    anam-org/metaxy

    Use Sybil for testing code examples in documentation and docstrings.

    124 GitHub stars~1.6k tokensUpdated 10 days ago
    Auto-check passed

Categories

Questions about Claude Improve Config

What does Claude Improve Config do?

Self-reflect on the current session to identify mistakes and propose improvements to .claude configuration (CLAUDE.md, hooks, skills). Claude Improve Config is an agent skill from anam-org/metaxy.md, hooks, skills).

When should I use Claude Improve Config?

Claude Improve Config fits situations like: tasks that involve Agent instruction files.

How do I install Claude Improve Config in Claude Code?

Run `npx skills add anam-org/metaxy --skill claude-improve-config -a claude-code`. Or copy the skill folder (.claude/skills/claude-improve-config in anam-org/metaxy) into .claude/skills/claude-improve-config in your project. Claude Code loads it when a task matches its description.

How do I install Claude Improve Config in Codex?

Run `npx skills add anam-org/metaxy --skill claude-improve-config -a codex`. Or copy the skill folder (.claude/skills/claude-improve-config in anam-org/metaxy) into .agents/skills/claude-improve-config in your project. Codex loads it when a task matches its description.

Can I use Claude Improve Config 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 anam-org/metaxy --skill claude-improve-config -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/claude-improve-config, .gemini/skills/claude-improve-config, .github/skills/claude-improve-config and .opencode/skills/claude-improve-config in your project.

What does Claude Improve Config need to run?

SKILL.md names no scripts, command-line tools or credentials: Claude Improve Config is instructions for the agent only.

Does Claude Improve Config 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 Claude Improve Config 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 Claude Improve Config use?

Claude Improve Config 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 Claude Improve Config use?

About 1k tokens (SKILL.md is roughly 4k 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 Claude Improve Config?

Skills that share tags, products or a category with Claude Improve Config: Using Agent Skills (addyosmani/agent-skills, 105k stars), Claude Reflect (BayramAnnakov/claude-reflect, 1.8k stars), Writing For Agents (bestofjs/bestofjs, 3.1k stars) and Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Improve Config?

anam-org (a GitHub organization) maintains it in anam-org/metaxy, which has 124 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 30, 2026.

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