skills.rest
tjmaynes
tjmaynesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agent-context-generator

Generate a structured AGENTS.md onboarding guide from repository discovery.

3|Updated Jan 9, 2026
Search Tags:#templates#documentation#onboarding#agents#guides#agents.md#workflows
One-click install
npx skills add https://github.com/tjmaynes/skills --skill agent-context-generator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-context-generator
Source: https://github.com/tjmaynes/skills/tree/main/skills/agent-context-generator
Command: npx skills add https://github.com/tjmaynes/skills --skill agent-context-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill helps teams create clear, consistent AGENTS.md onboarding guides for projects that lack up-to-date guidance, reducing handoffs and ambiguity.

Core Features & Use Cases

  • Generates a structured AGENTS.md tailored to repository layout, tooling, and workflows.
  • Captures conventions, ownership, testing expectations, and review processes to guide future agents.
  • Produces a per-directory scope plan when applicable and surfaces unresolved questions for the maintainer.

Quick Start

Run discovery on the repository to produce an AGENTS.md tailored to its structure and tooling.

Frequently Asked Questions about agent-context-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an AGENTS.md onboarding guide for my repository?▼

To generate an AGENTS.md onboarding guide, run repository discovery to audit layout, tooling, tasks, testing, and documentation references, producing a scaffolded guide with structured sections for future agents.

What is an AGENTS.md file and when do I need one for my project?▼

An AGENTS.md file is a structured onboarding guide that captures repository conventions, ownership, testing expectations, and review processes. You need one to reduce handoff ambiguity and provide clear project guidance for new agents.

How do I create onboarding documentation that covers repository tooling and workflows?▼

Create onboarding documentation by auditing repository layout and tooling to produce a scaffolded guide. The output includes sections for Quick Facts, Repository Tour, Common Tasks, Testing & Quality Gates, and Workflow Expectations.

Can I use an AGENTS.md generator for projects with complex directory structures?▼

Yes, the generator applies to projects with complex layouts and produces per-directory scope notes when applicable. It audits the repository structure and surfaces unresolved questions for the maintainer to resolve.

What's the best way to document testing expectations and quality gates for development agents?▼

Document testing expectations by auditing repository tooling and workflows to produce a scaffolded guide. The output includes dedicated Testing & Quality Gates and Workflow Expectations sections to guide future agents.

What sections should I include in repository onboarding documentation for agents?▼

Repository onboarding documentation should include Quick Facts, Repository Tour, Tooling & Setup, Common Tasks, Testing & Quality Gates, Workflow Expectations, Documentation Duties, and Finish the Task sections for complete project coverage.

Related Skills

Explore More Content & Communication Skills→
senior-sigansenior-sigan

index-repo

Index repository content into a structured PROJECT_INDEX.md file.

Community
Advanced
Markson22Markson22

reversa-clarify

Generate up to five clarifying questions and merge answers into requirements.md.

Community
Advanced
aayushsoamaayushsoam
1

codebase-onboarding

Analyze an unfamiliar codebase and generate an onboarding guide with architecture maps and a starter CLAUDE.md.

Community
Advanced
windyskywindysky

moai-docs-generation

Generate documentation patterns from code for Sphinx, MkDocs, TypeDoc, and Nextra.

Community
Advanced