agents-maintenance

agents-maintenance is a skill for Claude Code from parisgroup-ai/imersao-ia-setup. It costs 61 tokens per session (3,212 once invoked), scanned A, original, MIT.

A maintenance skill for monorepos, which are repositories that contain multiple apps or packages. It checks instruction files such as CLAUDE.md and AGENTS.md for consistent structure and links.

In plain words
What is it for?
Use it when adding or moving apps and packages, checking broken instruction links, or validating guidance after a refactor.
Why use it?
It helps prevent agents from following conflicting, outdated, incomplete, or disconnected instructions across a large repository.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions CLAUDE.md; mentions AGENTS.md.

Part of the imersao plugin — 51 skills, 7 commands shipped together

Good fit Use it when adding or moving apps and packages, checking broken instruction links, or validating guidance after a refactor.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/parisgroup-ai/imersao-ia-setup/agents-maintenance
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 parisgroup-ai/imersao-ia-setup --skill agents-maintenance
Clone the repo
git clone --depth 1 https://github.com/parisgroup-ai/imersao-ia-setup

Made for: Claude Code.

Or install imersao, the plugin that ships this one along with the rest of its 51 skills, 7 commands.

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 agents-maintenance

README.md
[![agentmods](https://agentmods.dev/badge/skills/parisgroup-ai/imersao-ia-setup/agents-maintenance/github.svg)](https://agentmods.dev/skills/parisgroup-ai/imersao-ia-setup/agents-maintenance)
Your own site
<a href="https://agentmods.dev/skills/parisgroup-ai/imersao-ia-setup/agents-maintenance"><img src="https://agentmods.dev/badge/skills/parisgroup-ai/imersao-ia-setup/agents-maintenance/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 agents-maintenance

Your own site · 80×15
<a href="https://agentmods.dev/skills/parisgroup-ai/imersao-ia-setup/agents-maintenance"><img src="https://agentmods.dev/badge/skills/parisgroup-ai/imersao-ia-setup/agents-maintenance.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 61 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,212 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.00061 $0.03212
Opus 5 $0.00030 $0.01606
Sonnet 5 $0.00012 $0.00642
Haiku 4.5 $0.00006 $0.00321

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

Security

Grade A, and why

agents-maintenance 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 11d 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.

plugins/imersao/skills/agents-maintenance/SKILL.md · 401 lines

How it starts

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

Agents Maintenance

Overview

Mantém consistência entre arquivos de instrução (CLAUDE.md, AGENTS.md, READMEs) em monorepos. Valida estrutura, links bidirecionais, timestamps e detecta redundâncias/conflitos.

Princípio central: Cada nível do monorepo tem um par CLAUDE.md → [[AGENTS.md]], formando hierarquia navegável.

When to Use

Use quando:

  • Iniciar sessão em monorepo com múltiplos apps/packages
  • Criar/mover/renomear apps ou packages
  • Suspeitar de instruções desatualizadas ou conflitantes
  • Links quebrados entre arquivos de instrução
  • Após refatorações que movem código entre módulos

Não use quando:

  • Projeto single-app sem subdiretórios
  • Apenas editando código (não instruções)

Estrutura Esperada

raiz/
├── CLAUDE.md ─────→ [[AGENTS.md]]
├── AGENTS.md       (índice geral de agentes)
│
├── apps/
│   └── app1/
│       ├── CLAUDE.md ─→ [[AGENTS.md]]
│       ├── AGENTS.md ─→ [[../../AGENTS.md]] (link pai)
│       └── README.md
│
└── packages/
    └── shared/
        ├── CLAUDE.md ─→ [[AGENTS.md]]
        ├── AGENTS.md ─→ [[../../AGENTS.md]] (link pai)
        └── README.md

Regras:

  1. Todo CLAUDE.md DEVE ter [[AGENTS.md]]
  2. Todo AGENTS.md filho DEVE linkar para pai
  3. AGENTS.md raiz lista todos os agentes/apps

Checklist de Validação

Execute na ordem:

1. Descoberta e Identificação de Candidatos

1.1 Encontrar arquivos existentes:

find . -name "CLAUDE.md" -o -name "AGENTS.md" -o -name "README.md"

1.2 Identificar áreas que DEVERIAM ter AGENTS.md:

Indicador Por que precisa de AGENTS.md
Tem package.json próprio App/package independente
Tem tsconfig.json próprio Configuração específica
Tem pasta src/ ou lib/ Código fonte significativo
Tem pasta tests/ ou __tests__/ Lógica testável
Tem Dockerfile Deploy independente
Tem README.md sem AGENTS.md Documentado mas sem instruções
Diretório em apps/, packages/, services/, modules/ Convenção de monorepo
Mais de 10 arquivos .ts/.js Volume de código significativo

Read the full file on GitHub · 401 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. 11d ago First seen · 401 lines · 61 tokens per session scan A b2d07e0ba37e

Subscribe to this mod's changes

agents-maintenance is a skill published in the GitHub repository parisgroup-ai/imersao-ia-setup (1 stars, last pushed 29d ago), licensed MIT. It adds 61 tokens to every session and 3,212 once invoked, about $0.0003 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

improve-code-quality

Guided journey from a working-but-untested vibe-coded prototype to a production-ready product with tests, clean structure, a business-rules boundary, and resilience at scale. Orchestrates nine skills phase by phase - working-with-legacy-code, clean-code, refactoring-patterns, software-design-philosophy…

wondelai/skills · 227 tokens

refactoring-patterns

Apply named refactoring transformations to improve code structure without changing behavior. Use when the user mentions "refactor this", "code smells", "extract method", "replace conditional", "technical debt", "move method", "inline variable", "decompose conditional", or "clean up this messy code". Also trigger when…

wondelai/skills · 125 tokens

han-release

Cut a Han release: update CHANGELOG.md with the changes since the last release, bump and tag every plugin that changed as {plugin-name}--v{version} so a version-constrained dependency can resolve, and publish a GitHub release crediting every merged pull request and closed issue to the people behind it. Use when…

testdouble/han · 172 tokens

han-update-documentation

Update Han plugin documentation so every skill, agent, guidance doc, index, and cross-reference is current and accurate. On a non-default branch, scopes the pass to entities the branch actually touched. On the default branch, performs a full documentation sweep across the whole plugin. Use when updating, refreshing…

testdouble/han · 167 tokens

spike-consumer-baseline

OI-3 spike harness — heavy consumer skill, BASELINE arm. Builds an incident post-mortem and sources the readability standard mid-workflow by reading a file directly, with NO Skill-tool call. Use only when explicitly invoked by the spike harness with a TRIALID and data path.

testdouble/han · 66 tokens

spike-guidance-forked

OI-3 spike harness — the FORKED (context fork) readability-guidance variant. Same payload as the inline variant but declared to run in a forked context. Use only when a spike consumer skill invokes it.

testdouble/han · 53 tokens