Skip to main content
skill CX Codex

agent-rules — Claude Code skill: what it does, how to install

Generates and verifies AGENTS.md instruction files for AI coding agents. Keeps project guidelines structured and under strict line limits.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add netresearch/agent-rules-skill --skill agent-rules -a claude-code
Open on GitHub

What agent-rules does

This skill creates machine-oriented documentation following the AGENTS.md convention. It inspects the repository, identifies languages and build tools across Go, PHP, TypeScript, or Python, and extracts CI quality gates. It can also link CLAUDE.md and GEMINI.md automatically.

Under the hood, several bash utilities inspect scopes, score files, and verify that documented shell commands execute properly. Scripts must be invoked via their full ${CLAUDE_SKILL_DIR} path. Relative paths trigger security permission prompts on every call.

Execution requires bash 4.3+, jq 1.7+, and git 2.0+. The root AGENTS.md must stay under 150 lines, or CI harness validation checks fail.

What it helps with

  • scaffold AGENTS.md files for new or existing codebases
  • verify documented commands and paths against actual code
  • audit and grade existing AI agent documentation
  • create symlinks for CLAUDE.md and GEMINI.md automatically

Example prompts for the agent

  • Generate an AGENTS.md file for this project
  • Verify that all commands in AGENTS.md are working
  • Score the quality of existing agent rule files

How to install agent-rules

1Skills CLI (Vercel)

npx skills add netresearch/agent-rules-skill --skill agent-rules -a claude-code

2Manually: put the files in place

~/.claude/skills/agent-rules/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/agent-rules/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-rules

How to install agent-rules in Claude Code?

Run npx skills add netresearch/agent-rules-skill --skill agent-rules -a claude-code. The skill file will be placed in ~/.claude/skills/agent-rules/SKILL.md.

What does the agent-rules skill do?

It detects your project configuration, extracts build commands, and generates structured AGENTS.md guidelines for coding assistants.

What dependencies does agent-rules require?

You need bash 4.3+, jq 1.7+, and git 2.0+. The generated root file must also stay strictly under 150 lines to pass harness checks.

Similar skills

All skills for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor