aif-docs

To generate project documentation, this Skill creates a lean landing-page README as the main entry point and builds a structured docs/ directory with one page per topic for architecture, setup, and API references.

Organizing project documentation is best handled by applying a topic-based docs structure with a landing-page README, using YAML frontmatter for discovery and navigation headers for consistent linking across architecture and contributor guidance pages.

A topic-based docs structure improves content discoverability by assigning one page per topic and utilizing YAML frontmatter, navigation headers, and See Also sections to ensure consistent linking and easy navigation across the project directory.

Yes, you can use this documentation generator for API references and contributor guidance. It applies to both onboarding and ongoing projects by generating individual topic pages for each specific documentation need.

No specific dependencies are required to create a docs directory with a landing page. The Skill operates independently to generate the README and topic-based documentation structure directly within your project.

You should not use a lean landing page approach if your project requires deeply nested, multi-level documentation hierarchies, as this Skill focuses on a flat, topic-based structure with one page per topic for straightforward navigation.