Will it break my documentation site build?

No, the skill includes a mandatory verification step that runs 'bun run build' to ensure the site compiles without errors before finishing the task.

Does it support languages other than Spanish?

The current version is configured to write content in Spanish to match the target project's requirements, though the logic can be adapted for other languages.

Which documentation frameworks does this skill support?

This skill is specifically optimized for Astro Starlight documentation sites, utilizing its specific file structure and component library.

How does the skill identify which files to update?

It uses git commands (git diff) to identify modified source code and matches those changes against a mapping table or a project-specific configuration file.

Can it handle screenshots and visual assets?

Yes, the skill automatically scans for new screenshots in the assets directory and embeds them into relevant end-user guides with descriptive alt text.

Astro Starlight Documentation Sync

Name: Astro Starlight Documentation Sync
Author: Grupo-AFAL

byGrupo-AFAL

•

Aprendizaje y Documentación

Synchronizes Astro Starlight documentation with recent source code changes to ensure accurate and up-to-date technical guides.

This skill automates the process of maintaining Astro Starlight documentation sites by analyzing git diffs to identify code changes that require documentation updates. It intelligently maps Rails controllers, models, and services to relevant MDX files, ensuring that documentation remains the source of truth for the application. The skill prioritizes end-user task guides, generates Mermaid diagrams for complex workflows, and integrates project screenshots—all while adhering to Spanish language requirements and verifying the final build for production readiness.

Características Principales

01Automated git diff analysis to identify documentation gaps in real-time.

02Automated build verification using Bun to ensure zero documentation errors.

031 GitHub stars

04Native support for Mermaid diagrams to visualize complex logic and workflows.

05Intelligent mapping of Rails code architecture to MDX documentation structures.

06Automatic sidebar management within Astro configuration files.

Casos de Uso

01Synchronizing user manuals immediately after refactoring Rails controllers or models.

02Automatically generating new documentation pages for newly added features or API endpoints.

03Maintaining a technical reference section that stays current with internal service changes.

Características Principales

01Automated git diff analysis to identify documentation gaps in real-time.

02Automated build verification using Bun to ensure zero documentation errors.

031 GitHub stars

04Native support for Mermaid diagrams to visualize complex logic and workflows.

05Intelligent mapping of Rails code architecture to MDX documentation structures.

06Automatic sidebar management within Astro configuration files.

Casos de Uso

01Synchronizing user manuals immediately after refactoring Rails controllers or models.

02Automatically generating new documentation pages for newly added features or API endpoints.

03Maintaining a technical reference section that stays current with internal service changes.