Skip to content
Back to skills

Maintain Project Agents

ASecurity

Maintain AGENTS.md as the agent-policy member of the canonical four-document repository suite.

  • 7 stars
  • 0 votes
  • 0 copies
  • 1 view
  • Added September 5, 2026
ai-agentsrailsdocumentation

Security analysis

A100/100

Pro scans all 4 files and shows the line behind each finding

Scanned September 5, 2026

npx -y skills add gaelic-ghost/socket --skill maintain-project-agents --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Maintain Project Agents?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Maintain Project Agents
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/gaelic-ghost-maintain-project-agents/badge)](https://www.skillsdirectory.com/skills/gaelic-ghost-maintain-project-agents)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: maintain-project-agents
description: Maintain AGENTS.md as the agent-policy member of the canonical four-document repository suite.
---

# Maintain Project Agents

## Purpose

Keep project-local `AGENTS.md` compact, durable, grounded, and specific while
README, CONTRIBUTING, AGENTS, and ROADMAP are maintained together.

## Commands

The complete documentation command surface is:

```text
just docs-check
just docs-apply
```

Both commands process all four documents. Do not create per-file recipes or
document direct `.fsx` entrypoints.

## Managed Contract

- `assets/document.contract.json` fixes structure, ordering, and aliases.
- `assets/AGENTS.template.md` supplies deterministic bootstrap scaffolding.
- No project-local structural customization is supported.
- Existing grounded policy and allowed additional sections are preserved.

## AGENTS Ownership

AGENTS owns repository scope, source-of-truth routing, change boundaries,
commands, review and delivery rules, safety boundaries, and local overrides.
Product prose belongs in README, contributor workflow in CONTRIBUTING, and
planning in ROADMAP.

## Deterministic Workflow

Use `just docs-check` for the full no-write audit and `just docs-apply` for the
atomic four-document apply. The coordinator validates every proposed document
before it writes any of them and rolls back completed replacements on failure.

## Guardrails

- Never maintain AGENTS separately from the full document suite.
- Never invent commands, toolchains, packaging surfaces, or policy.
- Never add structural customization or alternate document modes.
- Never commit, push, or open a pull request as part of documentation upkeep.

## References

- `assets/document.contract.json`
- `assets/AGENTS.template.md`

Files in this skill

  • SKILL.md1.7 KB
  • agents/openai.yaml450 B
  • assets/AGENTS.template.md1.9 KB
  • assets/document.contract.json1.5 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…