opensite-ai/opensite-skills / agent-file-engine
agent-file-engine
VerifiedRepository-specific AGENTS.md authoring and maintenance workflow. Use when creating, refreshing, or expanding AGENTS.md coverage for a codebase, including deciding whether nested AGENTS.md files are needed for subsystems with distinct rules, workflows, or AI-sensitive constraints.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.0 KB |
| agents/openai.yaml | config | 402 B |
| examples/coverage-plan.md | markdown | 829 B |
| references/activation.md | markdown | 851 B |
| references/discovery-checklist.md | markdown | 1.3 KB |
| references/nested-coverage-heuristics.md | markdown | 1.5 KB |
| scripts/inventory_agent_scope.py | script | 6.4 KB |
| templates/nested-agents.md | markdown | 634 B |
| templates/root-agents.md | markdown | 1013 B |
templates/root-agents.md
View on GitHub# AGENTS.md - Instructions for coding agents working on `<repo>`
This file is for AI coding agents and maintainers. It captures the non-obvious rules, architecture, and workflows of this codebase so automated changes stay safe and consistent.
When in doubt, favor: `(1) ... , (2) ... , (3) ...`.
## 1. Quick mental model
- What the repo is
- Who consumes it
- How it is organized
- The main data or control flow
## 2. Golden rules
1. Rule with strong consequence
2. Rule about contracts or architecture
3. Rule about performance, security, or verification
## 3. Key directories
- `src/...` - purpose
- `app/...` - purpose
- `components/...` - purpose
## 4. Common workflows
### 4.1 Modify existing code
- Where to start
- What to preserve
- What commands to run
### 4.2 Add new code
- Which existing patterns to copy
- Which registries, exports, or routes must be updated
## 5. Verification
- `...`
- `...`
## 6. Additional agent docs
- See `path/to/nested/AGENTS.md` for subtree-specific rules.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |