adaptive-docs-init

Bootstrap an agent-agnostic adaptive documentation system with AGENTS.md, docs/ai, and .agents/skills.

25|4|Updated Sep 5, 2010
One-click install
npx skills add https://github.com/divad12/dotfiles --skill adaptive-docs-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adaptive-docs-init
Source: https://github.com/divad12/dotfiles/tree/main/.claude/skills/adaptive-docs-init
Command: npx skills add https://github.com/divad12/dotfiles --skill adaptive-docs-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bootstrap the agent-agnostic adaptive documentation system in a project. Create a standard structure across projects to reduce setup friction by provisioning AGENTS.md, docs/ai, the .agents/skills directory, the .claude/skills symlink, a root AGENTS.md, and a starter docs/ai/architecture.md placeholder when needed.

Core Features & Use Cases

  • Automated scaffolding: creates AGENTS.md, docs/ai, and the .agents/skills directory to standardize documentation and skill usage across agents.
  • Symlink support: establishes a .claude/skills symlink to centralize shared skills while keeping project structure clean.
  • Optional architecture starter: can scaffold docs/ai/architecture.md with a mermaid placeholder for early diagramming.
  • Non-destructive setup: avoids overwriting existing files and provides guidance to refactor later with /adaptive-docs-extract.

Quick Start

Run this skill in your project to scaffold AGENTS.md, docs/ai, and the .agents/skills structure.

Frequently Asked Questions about adaptive-docs-init

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

FAQPage Schema
How do I bootstrap AI documentation for my project?

To bootstrap adaptive documentation, this Skill non-destructively scaffolds a standard structure including AGENTS.md, docs/ai, and the .agents/skills directory. It provisions these components to standardize documentation and skill usage across agents without overwriting existing files.

What is an agent-agnostic documentation structure?

An agent-agnostic documentation structure standardizes how AI agents interact with a project by provisioning a root AGENTS.md, a docs/ai directory, and shared skill directories. This creates a consistent baseline for agent context across different platforms.

How do I set up a .claude/skills symlink for shared skills?

To set up a .claude/skills symlink, this Skill establishes the link during the bootstrap process to centralize shared skills. It keeps your project structure clean while ensuring agents can locate and utilize the provisioned skill files.

Can I scaffold architecture diagrams when initializing AI docs?

Yes, you can scaffold architecture diagrams during initialization. The Skill can optionally create a starter docs/ai/architecture.md file with a mermaid placeholder to support early diagramming and architectural planning.

Will bootstrapping project documentation overwrite my existing files?

Bootstrapping project documentation will not overwrite your existing files. The setup is non-destructive, only creating missing pieces like AGENTS.md and docs/ai, and provides guidance to refactor existing content later using /adaptive-docs-extract.