sg-template-docs

Generate README.md and DOCUMENTATION.md from StackGuardian Terraform module files and schemas.

Updated Nov 24, 2020
One-click install
npx skills add https://github.com/hllvc/dotfiles --skill sg-template-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sg-template-docs
Source: https://github.com/hllvc/dotfiles/tree/main/.claude/skills/sg-template-docs
Command: npx skills add https://github.com/hllvc/dotfiles --skill sg-template-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates two comprehensive documentation files for StackGuardian Terraform templates, aligning developer and user documentation and reducing manual writing time.

Core Features & Use Cases

  • Analyzes Terraform module files (variables.tf, outputs.tf, versions.tf) to populate technical README content.
  • Generates a developer-facing README.md and a user-facing DOCUMENTATION.md using schema definitions from schemas/ (input_schema.json and ui_schema.json).
  • Produces well-structured docs that reflect the module's configuration and user-facing parameters for quick publishing.

Quick Start

Run the sg-template-docs skill in the module directory to generate README.md and DOCUMENTATION.md.

Frequently Asked Questions about sg-template-docs

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

FAQPage Schema
How do I generate documentation for Terraform templates automatically?

You can generate Terraform template documentation automatically by running a skill that analyzes module files like variables.tf and outputs.tf to populate technical README content. It extracts variable definitions and module configurations to produce well-structured docs without manual writing.

What's the best way to create a user-facing DOCUMENTATION.md from Terraform schema definitions?

Creating user-facing DOCUMENTATION.md from schema definitions is best handled by parsing input_schema.json and ui_schema.json to extract user-facing parameters. This approach ensures the resulting documentation reflects the module's configuration for quick publishing.

Does this documentation generation approach work with StackGuardian templates?

Yes, this documentation generation approach works specifically with StackGuardian templates. It analyzes the module sources and schema definitions to ensure the resulting docs follow the prescribed structure for prerequisites, configuration, outputs, security, and usage.

Can I generate both developer and user documentation for my Terraform module at the same time?

You can generate both developer and user documentation for a Terraform module simultaneously by analyzing module files and schemas together. This produces a developer-facing README.md and a user-facing DOCUMENTATION.md, aligning both documents in one run.

What Terraform files do I need to prepare before auto-generating module documentation?

Before auto-generating module documentation, you need to prepare Terraform files including variables.tf, outputs.tf, and versions.tf. You also need schema definitions in schemas/input_schema.json and ui_schema.json to populate the technical and user-facing content accurately.