Agent skill

Agents Md Manager

Audit, generate, update, and lint AGENTS.md files across all projects.

Install Agents Md Manager

skills CLI

$ npx skills add espennilsen/pi --skill agents-md-manager -a claude-code

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

GitHub CLI

$ gh skill install espennilsen/pi agents-md-manager --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/espennilsen/pi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agents-md-manager .claude/skills/agents-md-manager && 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/

Paste into Claude Code

Install the "agents-md-manager" agent skill from https://github.com/espennilsen/pi/tree/main/skills/agents-md-manager into .claude/skills/agents-md-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-manager", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/espennilsen/pi/tree/main/skills/agents-md-manager

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add espennilsen/pi --skill agents-md-manager -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install espennilsen/pi agents-md-manager --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/agents-md-manager .agents/skills/agents-md-manager && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "agents-md-manager" agent skill from https://github.com/espennilsen/pi/tree/main/skills/agents-md-manager into .agents/skills/agents-md-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-manager", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add espennilsen/pi --skill agents-md-manager -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install espennilsen/pi agents-md-manager --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/agents-md-manager .cursor/skills/agents-md-manager && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "agents-md-manager" agent skill from https://github.com/espennilsen/pi/tree/main/skills/agents-md-manager into .cursor/skills/agents-md-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-manager", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/espennilsen/pi.git --path skills/agents-md-manager

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add espennilsen/pi --skill agents-md-manager -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install espennilsen/pi agents-md-manager --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/agents-md-manager .gemini/skills/agents-md-manager && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "agents-md-manager" agent skill from https://github.com/espennilsen/pi/tree/main/skills/agents-md-manager into .gemini/skills/agents-md-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-manager", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install espennilsen/pi agents-md-manager

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add espennilsen/pi --skill agents-md-manager -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/agents-md-manager .github/skills/agents-md-manager && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "agents-md-manager" agent skill from https://github.com/espennilsen/pi/tree/main/skills/agents-md-manager into .github/skills/agents-md-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-manager", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add espennilsen/pi --skill agents-md-manager -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install espennilsen/pi agents-md-manager --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/agents-md-manager .opencode/skills/agents-md-manager && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "agents-md-manager" agent skill from https://github.com/espennilsen/pi/tree/main/skills/agents-md-manager into .opencode/skills/agents-md-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-manager", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: agents-md-manager
GitHub stars: 122
Token cost: ~957 tokens
SKILL.md length: 432 words
Files: 1
Skills in repo: 36
Repo updated: Sep 21, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Audit, generate, update, and lint AGENTS.md files across all projects.

Works in 5 steps: Audit — Cross-project health check → Generate — Create AGENTS.md for a project → Update — Refresh specific sections → …
Asked to check project context files
SKILL.md covers Available Operations, Batch Mode and Integration with Other Tools
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agents Md Manager is an agent skill from espennilsen/pi. Audit, generate, update, and lint AGENTS.md files across all projects. Use when asked to check project context files, scaffold AGENTS.md for new projects, update stale ones, or run a cross-project audit.

Its SKILL.md is about 960 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 and Linting and formatting. The licence is MIT.

When your agent uses it

Asked to check project context files
Scaffold AGENTS.md for new projects
Update stale ones
Run a cross-project audit

Example prompts

“/agents-md-manager”

Workflow steps

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

Audit — Cross-project health check
Generate — Create AGENTS.md for a project
Update — Refresh specific sections
Sync Check — Detect drift
Lint — Quality check

What it can do on your machine

Read from SKILL.md and the folder at commit 79d019b. 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).
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

Agents Md Manager loads about 957 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 432 words of instructions outside code blocks.

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

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 espennilsen/pi at commit 79d019b, republished under its MIT licence (© espennilsen). 432 words, ~957 tokens.

Download SKILL.mdSave it as .claude/skills/agents-md-manager/SKILL.md (or your agent's skills folder).

name: agents-md-manager
description: Audit, generate, update, and lint AGENTS.md files across all projects. Use when asked to check project context files, scaffold AGENTS.md for new projects, update stale ones, or run a cross-project audit.

AGENTS.md Manager

Maintain AGENTS.md project context files across all ~/Dev projects.

Available Operations

1. Audit — Cross-project health check

Scan all projects and report AGENTS.md / .pi/ / td status:

bash

# Use the project_init tool in batch mode

Use project_init with action: "batch" to get a full overview. Then provide a table:

Project	Stack	AGENTS.md	.pi/	td	Status

Flag projects that:

Have code but no AGENTS.md (needs init)
Have AGENTS.md but no .pi/ or td (partially set up)
Are fully ready ✅

2. Generate — Create AGENTS.md for a project

Use project_init with action: "detect" first to preview, then action: "init" to create.

After auto-generation, review and enhance the output by:

Reading README.md for project description and purpose
Checking package.json scripts for accurate quick-start commands
Looking at src/ structure for meaningful directory descriptions
Adding project-specific conventions found in configs (ESLint rules, Prettier settings)
Adding deployment info if found (Dockerfile, CI workflows, deploy scripts)

3. Update — Refresh specific sections

When a project has changed significantly:

Read current AGENTS.md
Run project_init with action: "detect" to get fresh stack profile
Compare detected state against documented state
Update only stale sections, preserving manual edits in other sections

Key sections to check:

Stack: Dependencies changed?
Quick Start: New scripts added/removed?
Directory Layout: New top-level dirs?
Conventions: Linting/formatting tools changed?
Key Files: New config files?

Use the edit tool for surgical updates — don't rewrite the entire file.

4. Sync Check — Detect drift

Compare AGENTS.md claims against reality:

bash

# Check if referenced directories exist
# Verify scripts in package.json match what's documented
# Confirm referenced config files exist
# Check if new top-level dirs aren't documented

For each project with AGENTS.md:

Read the AGENTS.md
Run project_init detect to get current profile
Compare:
- Listed directories vs actual directories
- Documented scripts vs actual package.json scripts
- Referenced config files vs files on disk
- Stack description vs detected stack
Report drift items with suggested fixes

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

5. Lint — Quality check

Check AGENTS.md files for common issues:

Missing sections: No quick start, no directory layout
Stale paths: References to directories/files that don't exist
Generic content: Boilerplate without project-specific detail
Missing td mandate: No task management section
No description: Missing project purpose/overview
Broken commands: Script references that don't match package.json

Report with severity:

🔴 Critical: Missing or empty AGENTS.md in active project
🟡 Important: Stale content, missing key sections
🔵 Minor: Formatting, generic descriptions

Batch Mode

When operating on multiple projects:

Start with audit to identify which projects need attention
Process projects by priority (active first, stale/archived last)
Show a summary of changes before applying
Always ask before writing to files

Integration with Other Tools

Use project_init for stack detection and initial generation
Use workon to switch context when doing deep updates
Use td to track large-scale AGENTS.md update campaigns
Use read and edit for surgical file modifications

Files

Just SKILL.md in skills/agents-md-manager of espennilsen/pi.

Open the folder on GitHubat commit 79d019b

Compare with similar skills

Agents Md Manager 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.

Agents Md Manager compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Agents Md Manager this skillespennilsen/pi	122	—	~957	Automated safety check: Pass	MIT	17 days ago
Agnixagent-sh/agnix	446	—	~874	Automated safety check: Pass	Apache-2.0	today
Harness Engineering10xChengTu/harness-engineering	102	1 repos	~1k	Automated safety check: Pass	None	2 mo ago
Agnixagent-sh/agnix	446	—	~563	Automated safety check: Pass	Apache-2.0	today
Writing Docsc15t/c15t	1.9k	—	~872	Automated safety check: Pass	Apache-2.0	today
Review Agents Mddominik1001/caldav-mcp	103	—	~1.2k	Automated safety check: Pass	MIT	4 days ago

Similar skills

Agnix
agent-sh/agnix
A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.
446 GitHub stars~874 tokensUpdated today
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
Agnix
agent-sh/agnix
A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.
446 GitHub stars~563 tokensUpdated today
Agent WorkflowsAuto-check passed
Writing Docs
c15t/c15t
Author or edit c15t documentation in docs//.mdx — the source for both the c15t.com site and the docs bundled into published packages.
1.9k GitHub stars~872 tokensUpdated today
Agent WorkflowsAuto-check passed
Review Agents Md
dominik1001/caldav-mcp
Reviews an AGENTS.md or CLAUDE.md file against best practices and reports concrete fixes.
103 GitHub stars~1.2k tokensUpdated 4 days ago
Agent WorkflowsAuto-check passed
Harness Engineering Zh
10xChengTu/harness-engineering
为 AI Agent 友好的代码库搭建和改进 Harness 工程（包括 AGENTS.md、docs/、Lint 规则、Eval 系统、项目级 Prompt 工程）。触发场景：为 AI Agent 设置新项目/空项目，创建 AGENTS.md 或 CLAUDE.md，关于 Harness 工程的问题，让 Agent 在代码库上更高效地工作。当用户感到沮丧或抱怨 Agent…
102 GitHub starsUsed in 1 repo~625 tokens
Agent WorkflowsAuto-check passed

Questions about Agents Md Manager

What does Agents Md Manager do?

Audit, generate, update, and lint AGENTS.md files across all projects. Agents Md Manager is an agent skill from espennilsen/pi.md files across all projects.

When should I use Agents Md Manager?

Agents Md Manager fits situations like: asked to check project context files; scaffold AGENTS.md for new projects; update stale ones; run a cross-project audit.

How do I install Agents Md Manager in Claude Code?

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

How do I install Agents Md Manager in Codex?

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

Can I use Agents Md Manager 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 espennilsen/pi --skill agents-md-manager -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agents-md-manager, .gemini/skills/agents-md-manager, .github/skills/agents-md-manager and .opencode/skills/agents-md-manager in your project.

What does Agents Md Manager need to run?

SKILL.md names no scripts, command-line tools or credentials: Agents Md Manager is instructions for the agent only.

Does Agents Md Manager 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 Agents Md Manager 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 Agents Md Manager use?

Agents Md Manager is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agents Md Manager use?

About 957 tokens (SKILL.md is roughly 3.8k 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 Agents Md Manager?

Skills that share tags, products or a category with Agents Md Manager: Agnix (agent-sh/agnix, 446 stars), Harness Engineering (10xChengTu/harness-engineering, 102 stars), Agnix (agent-sh/agnix, 446 stars) and Writing Docs (c15t/c15t, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agents Md Manager?

espennilsen (a GitHub user) maintains it in espennilsen/pi, which has 122 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 21, 2026.

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

Install Agents Md Manager

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

AGENTS.md Manager

Available Operations

1. Audit — Cross-project health check

2. Generate — Create AGENTS.md for a project

3. Update — Refresh specific sections

4. Sync Check — Detect drift

5. Lint — Quality check

Batch Mode

Integration with Other Tools

Files

Compare with similar skills

Similar skills

More from espennilsen/pi

Related

Questions about Agents Md Manager