Agent skill
agents-md-generator
Automatically generate comprehensive AGENTS.md files that teach AI agents how to work with a repository's structure, conventions, and guidelines
Install this agent skill to your Project
npx add-skill https://github.com/asadullah48/hackathon-superpowers/tree/main/skills/agents-md-generator
SKILL.md
AGENTS.MD Generator
Purpose
Generate AGENTS.md files that serve as onboarding documentation for AI coding agents. This file teaches agents about project structure, coding conventions, build processes, and development workflows.
Prerequisites
- Access to the target repository
- Understanding of the project's technology stack
- Write permissions to create AGENTS.md at repository root
Instructions
Step 1: Analyze Repository Structure
Use bash and view tools to explore repository contents.
Step 2: Identify Project Type
Determine if it's a full-stack app, API, mobile app, library, or CLI tool.
Step 3: Generate AGENTS.md Structure
Create sections for Overview, Tech Stack, Project Structure, Development Setup, Coding Standards, Testing, and Deployment.
Step 4: Customize by Project Type
Add type-specific guidance based on the project category.
Step 5: Add Decision Trees
Include decision flows for common development scenarios.
Step 6: Validate and Refine
Ensure completeness and clarity.
Best Practices
- Keep it current with architectural changes
- Include actual examples from the codebase
- Think from an AI agent's perspective
- Explain the "why" not just "what"
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
example-skill
Brief description of what this skill does and when to use it. Include trigger keywords that users would naturally mention.
caps-format-validator
Validate CAPS (Coding Agent Playbook Spec) playbooks for correctness, completeness, and compatibility with Claude Code and Goose
kubernetes-health-check
Verify Kubernetes cluster health, resource availability, and readiness before deploying applications
handoff
Compact the current conversation into a handoff document for another agent to pick up.
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
Didn't find tool you were looking for?