claude-md-management

claude-md-management is a skill for Claude Code from doancan/mags. It costs 71 tokens per session (1,744 once invoked), scanned A, original, MIT.

A set of rules for creating and maintaining CLAUDE.md files, which give Claude Code project-specific instructions and context. It explains where these files belong, including in monorepos, repositories that contain multiple related projects or packages.

In plain words
What is it for?
Use it when setting up a project, defining coding conventions, configuring Claude Code, or adding different instructions for separate packages.
Why use it?
It helps the coding assistant understand the right rules for the whole repository or for a particular part of it.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions Claude Code.

Part of the mags plugin — 17 skills, 2 agents shipped together

Good fit Use it when setting up a project, defining coding conventions, configuring Claude Code, or adding different instructions for separate packages.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/doancan/mags/claude-md-management
View source ↗ doancan/mags
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add doancan/mags --skill claude-md-management
Clone the repo
git clone --depth 1 https://github.com/doancan/mags

Made for: Claude Code.

Or install mags, the plugin that ships this one along with the rest of its 17 skills, 2 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for claude-md-management

README.md
[![agentmods](https://agentmods.dev/badge/skills/doancan/mags/claude-md-management/github.svg)](https://agentmods.dev/skills/doancan/mags/claude-md-management)
Your own site
<a href="https://agentmods.dev/skills/doancan/mags/claude-md-management"><img src="https://agentmods.dev/badge/skills/doancan/mags/claude-md-management/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for claude-md-management

Your own site · 80×15
<a href="https://agentmods.dev/skills/doancan/mags/claude-md-management"><img src="https://agentmods.dev/badge/skills/doancan/mags/claude-md-management.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 71 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,744 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00071 $0.01744
Opus 5 $0.00036 $0.00872
Sonnet 5 $0.00014 $0.00349
Haiku 4.5 $0.00007 $0.00174

Measured 10d ago against content hash f57962b55ae6, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

claude-md-management scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/claude-md-management/SKILL.md · 171 lines

How it starts

The opening of the file, as written. The whole thing — 171 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md Management

Purpose of CLAUDE.md

Treat CLAUDE.md as the entry point for Claude Code to understand a project. It is the first file read when Claude Code enters a repository. Write it as a concise project brief that enables Claude Code to work effectively without reading every file in the codebase.

CLAUDE.md is not documentation for humans. It is a configuration and context file for Claude Code. Optimize for machine comprehension, fast orientation, and actionable instructions.

File Placement

Place CLAUDE.md files at the appropriate scope:

  • Repository root (./CLAUDE.md): Project-wide rules, tech stack, conventions, and documentation pointers. This is the primary file and is always read first.
  • Subdirectory (./packages/api/CLAUDE.md): Module-specific rules that apply only when working within that directory. Use for monorepos or projects with distinct subsystems.
  • User home (~/.claude/CLAUDE.md): Personal preferences and global rules that apply across all projects. Use for universal coding style preferences, commit conventions, or agent configurations.

When multiple CLAUDE.md files exist, Claude Code merges them with this priority: user home (lowest) < repository root < subdirectory (highest). Subdirectory rules override root rules when working in that directory.

What to Include

Structure every CLAUDE.md with these sections. Include only sections that are relevant to the project.

Project Overview

Provide a brief description of what the project is and does. Keep it to 2-3 sentences. Include the primary purpose, the target users or audience, and the deployment model.

## Project Overview

Multi-tenant SaaS platform for managing mobile application deployments. Serves enterprise customers with role-based access, audit logging, and automated build pipelines. Deployed on AWS with Kubernetes.

Tech Stack

List the core technologies with their roles. Be specific about versions only when the version matters for compatibility or behavior.

Read the full file on GitHub · 171 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 171 lines · 71 tokens per session scan A f57962b55ae6

Subscribe to this mod's changes

claude-md-management is a skill published in the GitHub repository doancan/mags (3 stars, last pushed 7mo ago), licensed MIT. It adds 71 tokens to every session and 1,744 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

prior-art-search

Systematic 7-step methodology for comprehensive patent prior art searches and patentability assessments using BigQuery and CPC classification.

RobThePCGuy/Claude-Patent-Creator · 26 tokens

sanity-best-practices

Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, webhooks, Blueprints, and framework integrations such as Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen, and the App SDK. Use this…

sanity-io/agent-toolkit · 164 tokens

portable-text-serialization

Render and serialize Portable Text to React, Svelte, Vue, Astro, HTML, Markdown, and plain text. Use when implementing Portable Text rendering in any frontend framework, building custom serializers for non-standard block types, converting Portable Text to HTML strings server-side, converting Portable Text to Markdown…

sanity-io/agent-toolkit · 85 tokens

development-assistant

Guides through adding new features, MCP tools, analyzers, and extending the patent creator system.

RobThePCGuy/Claude-Patent-Creator · 24 tokens

mpep-search

Expert system for searching USPTO MPEP, 35 USC statutes, 37 CFR regulations, and post-Jan 2024 updates.

RobThePCGuy/Claude-Patent-Creator · 32 tokens

video-perception

Use when the user mentions a video file (.mp4, .mov, .avi, .mkv, .webm), a YouTube URL, asks to watch/analyze/review a video, or references video content in conversation.

jordanrendric/claude-video-vision · 51 tokens