doc-structure

Organize standardized documentation structures and agent integration templates for repository governance.

Updated Apr 7, 2026
Ready to run
npx skills add https://github.com/sayaya1090/handbook --skill doc-structure
๐Ÿ’ฌ Prompt for ChatGPT / Claude Chatโ–ผ
Please help me install this Agent Skill.
Skill: doc-structure
Source: https://github.com/sayaya1090/handbook/tree/main/.gemini/skills/doc-structure
Command: npx skills add https://github.com/sayaya1090/handbook --skill doc-structure

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

๋ฌธ์„œ ๊ตฌ์กฐ ๋ฐ ์—์ด์ „ํŠธ ์—ฐ๋™์— ๋Œ€ํ•œ ํ‘œ์ค€ ์ฒดํฌ๋ฆฌ์ŠคํŠธ์™€ ๋ชจ๋“ˆ ๋ ˆ๋ฒจ ๋ฌธ์„œ๋ฅผ ์‰ฝ๊ฒŒ ๊ตฌ์„ฑํ•˜๊ณ  ๊ฒ€์ฆํ•˜๋Š” ๋ฐ ํ•„์š”ํ•˜๋‹ค.

Core Features & Use Cases

  • ํ‘œ์ค€ํ™”๋œ ๊ตฌ์กฐ ํ…œํ”Œ๋ฆฟ: ํ”„๋กœ์ ํŠธ ์ „์ฒด์˜ docs/์™€ ๋ชจ๋“ˆ ๋ ˆ๋ฒจ ํŒŒ์ผ์˜ ์ผ๊ด€๋œ ๊ตฌ์„ฑ๊ณผ ์„น์…˜ ์ •์˜.
  • ์—์ด์ „ํŠธ ์—ฐ๋™ ์ฒดํฌ๋ฆฌ์ŠคํŠธ: ๋‚ด๋ถ€/์™ธ๋ถ€ ์—์ด์ „ํŠธ ์—ฐ๋™ ์š”๊ตฌ์‚ฌํ•ญ์„ ๋ชจ๋“ˆ README.md ๋ฐ USECASE.md์— ๋ฐ˜์˜.
  • Use Case ์‹œํ€€์Šค ๋ฐ ๋‹ค์ด์–ด๊ทธ๋žจ ๊ฐ€์ด๋“œ: ์—์ด์ „ํŠธ ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ์œ„ํ•œ USECASE.md ํฌ๋งท๊ณผ CLASS-DIAGRAM.md ์˜ˆ์‹œ๋ฅผ ์ œ๊ณต.

Quick Start

Update docs/ and each module README.md to include the agent integration checklist and required sections.

Frequently Asked Questions about doc-structure

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

FAQPage Schema
How do I standardize a markdown documentation structure for repository governance?โ–ผ

You can standardize markdown documentation structure by applying a consistent template across project docs and module README files. This ensures frontmatter presence with name and description fields, along with required sections for repository governance.

What should I include in an agent integration checklist for a module README?โ–ผ

An agent integration checklist for a module README must include internal and external agent integration requirements. It should be explicitly reflected within the module README.md and USECASE.md to document agent scenarios and connectivity specifications.

How do I format USECASE.md files for agent scenario documentation?โ–ผ

Formatting USECASE.md files for agent scenarios requires following a standardized sequence and diagram guide. This includes defining specific use case sequences and incorporating CLASS-DIAGRAM.md examples to visualize agent interactions and structural relationships.

Does this documentation template require frontmatter in all Markdown files?โ–ผ

Yes, the documentation template requires frontmatter in all Markdown files to ensure standardization. Each file must explicitly include name and description fields within its frontmatter to pass repository governance validation checks.

What is the best way to organize project-level docs and module-level documentation together?โ–ผ

The best way to organize project-level and module-level documentation is using a standardized structure that defines consistent sections across both. This approach maps project docs and module READMEs while integrating explicit agent connectivity checklists into both levels.