readme-generate

Generate README.md documentation for Spring Boot modules from source analysis.

2.8k|1.2k|Updated Dec 12, 2024
One-click install
npx skills add https://github.com/spring-ai-alibaba/examples --skill readme-generate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: readme-generate
Source: https://github.com/spring-ai-alibaba/examples/tree/main/.claude/skills/readme-generate
Command: npx skills add https://github.com/spring-ai-alibaba/examples --skill readme-generate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill automatically generates comprehensive README.md files for Spring Boot modules based on task specification requirements.

Core Features & Use Cases

  • Automatically analyzes module controllers, dependencies, and configurations to produce consistent API documentation, usage examples, and testing guidance
  • Updates existing READMEs while preserving custom content and adding missing sections
  • Generates standardized, cross-module documentation with helpful links to test files and implementation details

Quick Start

Run the generator for a module: python .claude/skills/readme-generate/scripts/readme_generator.py <module_path> [output_file]

Frequently Asked Questions about readme-generate

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

FAQPage Schema
How do I auto-generate README.md documentation for Spring Boot modules?

To auto-generate README.md documentation for Spring Boot modules, run the generator script targeting your module path. The tool analyzes controllers, dependencies, configurations, and test files to produce a structured guide with API docs, usage, and testing sections.

What is the best way to update existing README files without losing custom content?

Updating existing README files without losing custom content is handled automatically by the generator. It preserves your custom sections while analyzing the module to add any missing standardized documentation, ensuring no manual overrides are lost during the update process.

Does the README generator analyze test files and configurations to document API endpoints?

Yes, the README generator analyzes test files and configurations to document API endpoints. It scans module controllers and dependencies to extract implementation details and automatically maps them into comprehensive API documentation within the README.

Can I use this to create cross-module documentation for a multi-module Spring Boot project?

You can use this to create cross-module documentation for a multi-module Spring Boot project. It generates standardized, consistent README files across multiple modules by analyzing each module's specific controllers, dependencies, and test files individually.

What sections are included when generating module documentation for Spring Boot?

Generating module documentation for Spring Boot includes sections for module description, API documentation, usage, implementation details, testing guidance, and notes. It automatically populates these structured sections by analyzing your controllers and configurations.

Why does my generated README lack testing guidance for my Spring Boot module?

Generated READMEs lacking testing guidance for your Spring Boot module usually occur when test files are missing or unrecognized in the specified module path. Ensure your test files are correctly placed so the generator can analyze them and populate the testing section.