agent-onboarding

Generates and updates AGENTS.md and CONTEXT.md documentation through interactive repo analysis.

1|Updated Sep 13, 2026
One-click install
npx skills add https://github.com/silentFellow/public-dotfiles --skill agent-onboarding-silentfellow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-onboarding
Source: https://github.com/silentFellow/public-dotfiles/tree/main/agents/skills/agent-onboarding
Command: npx skills add https://github.com/silentFellow/public-dotfiles --skill agent-onboarding-silentfellow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Repositories often lack clear onboarding documentation for AI agents, or existing AGENTS.md and CONTEXT.md files drift out of sync with the codebase. This Skill produces and refreshes both documents by combining automated repo exploration with an interactive question round, so agents start every session with accurate setup commands, conventions, and domain vocabulary. ## Core Features & Use Cases - Repo fact gathering: Dispatches a sub-agent to inspect manifests, lockfiles, CI config, scripts, and linter configs so users are never asked questions the repo already answers. - Interactive interview rounds: Uses numbered question batches with recommended answers to capture undocumented conventions, PR expectations, gotchas, and domain terminology. - Dual document output: Drafts AGENTS.md per a structured format (setup, build, test, conventions, gotchas) and CONTEXT.md as a domain glossary, with cross-referencing instead of duplicated content. - Living document maintenance: Reads existing files first, surfaces contradictions, and prunes stale sections on every update. - Use Case: Point it at a new monorepo to generate a root AGENTS.md covering workspace tooling plus a CONTEXT.md defining the team's domain terms before other agents start working in the codebase. ## Quick Start Ask the agent to onboard this repository by creating or updating its AGENTS.md and CONTEXT.md files.

Frequently Asked Questions about agent-onboarding

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

FAQPage Schema
How do I create an AGENTS.md file for my repository?▼

Run the agent-onboarding skill in your repo. It explores manifests, CI config, and scripts automatically, then asks targeted questions about conventions and gotchas before drafting an AGENTS.md with setup, build, test, and convention sections.

What is the difference between AGENTS.md and CONTEXT.md?▼

AGENTS.md documents how an agent operates in the repo: commands, conventions, and gotchas. CONTEXT.md is a domain glossary defining project-specific terminology and boundaries. The skill cross-references them instead of duplicating content.

Does agent-onboarding work with monorepos?▼

Yes. It asks whether the session covers the root only or also nested per-package AGENTS.md files. The closest AGENTS.md to the file being edited wins, following the same resolution convention as CLAUDE.md.

Can I update an existing AGENTS.md instead of overwriting it?▼

Yes. The skill reads existing AGENTS.md and CONTEXT.md files first, surfaces anything the repo contradicts, and prunes stale sections before adding new content. It never blindly overwrites existing documentation.

What questions does the onboarding interview ask?▼

It asks only what the repo cannot answer: undocumented conventions, commit and PR expectations, known gotchas, and domain terminology for CONTEXT.md. Questions come in numbered batches with recommended answers, and facts are gathered by a sub-agent in parallel.