agents-md-generatorlisted
Install: claude install-skill slogsdon/skills-workflows
# Skill: agents-md-generator
Produces a concise, integrator-focused AGENTS.md for repos that demonstrate one concept across multiple language implementations.
## Steps
### 1. Explore the repo structure
- List root-level files and directories
- Identify the language implementation folders (e.g. `php/`, `java/`, `dotnet/`)
- Read each language's README if present
- Read the root README
### 2. Extract the core concept
Answer: What is the single thing this repo teaches? Distill to one sentence: *"[verb] [what] using [how]"*.
### 3. Find the critical patterns
Look for:
- Non-obvious SDK/API choices that have consequences if wrong (e.g. using `Verify` vs `Charge`)
- Flags or parameters that are required but easy to miss
- Behaviors that activate automatically (e.g. mock mode)
- Files that are canonical reference implementations
For each pattern, capture the *why* — especially if getting it wrong has a real cost (penalty, security issue, data loss). This is the highest-value content in the file.
### 4. Map the files
For each language, identify:
- The core utility/helper file (canonical implementation)
- The endpoint/controller files
- The storage layer
- The mock/test helpers
- The frontend entry point (if present)
Note specific line ranges for the most important methods (SDK config, core pattern implementation).
### 5. Extract the API surface
List all REST endpoints with method, path, and one-line purpose. All languages should expose identical endpoints — confirm this