How do I install the 2138 Docsinstructions 58593deb skill?

Run npx skillmds@latest add tools-only/2138-docsinstructions-58593deb in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the 2138 Docsinstructions 58593deb skill do?

Standards for user-facing documentation in the docs/ folder It is listed under Docs & Writing on SkillMD.

Is 2138 Docsinstructions 58593deb safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with 2138 Docsinstructions 58593deb?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is 2138 Docsinstructions 58593deb free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published 2138 Docsinstructions 58593deb?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

2138 Docsinstructions 58593deb by tools-only

Name: 2138 Docsinstructions 58593deb
Author: tools-only

File contents

Documentation Standards

Instructions for creating and maintaining user-facing documentation in the docs/ folder.

Structure Requirements

File Header

Every doc file must start with:

# {Title}

> [Current Version](../VERSION.md) | {One-line description}

Single H1 Rule

Each file has exactly ONE H1 heading (the title). Use H2+ for all other sections.

Link Style

Use relative links for internal docs: [Quickstart](quickstart.md)
Use reference-style links for external URLs
No broken links (validated in CI)

Current Architecture (as of 2026-02-03)

Agents (8 total)

Agent	Purpose
`infraops-conductor`	Master orchestrator with approval gates
`requirements`	Gather infrastructure requirements
`architect`	WAF assessment and architecture design
`design`	Architecture diagrams and ADRs
`bicep-plan`	Implementation planning and governance
`bicep-code`	Bicep template generation
`deploy`	Azure deployment execution
`diagnose`	Post-deployment health diagnostics

Skills (8 total)

Skill	Category	Purpose
`azure-adr`	Document Creation	Architecture Decision Records
`azure-artifacts`	Artifact Generation	Template H2s, styling, generation rules
`azure-defaults`	Azure Conventions	Regions, naming, AVM, WAF, pricing, tags
`azure-diagrams`	Document Creation	Python architecture diagrams
`github-operations`	Workflow Automation	GitHub issues, PRs, CLI, Actions, releases
`git-commit`	Tool Integration	Commit conventions
`docs-writer`	Documentation	Repo-aware docs maintenance
`make-skill-template`	Meta	Skill creation helper

Prohibited References

Do NOT reference these removed agents/skills:

❌ diagram.agent.md → Use azure-diagrams skill
❌ adr.agent.md → Use azure-adr skill
❌ docs.agent.md → Use azure-artifacts skill
❌ azure-workload-docs skill → Use azure-artifacts skill
❌ azure-deployment-preflight skill → Merged into deploy agent
❌ orchestration-helper skill → Deleted (absorbed into conductor)
❌ github-issues / github-pull-requests skills → Use github-operations
❌ gh-cli skill → Merged into github-operations
❌ _shared/ directory → Use azure-defaults + azure-artifacts skills

Content Principles

Principle	Application
DRY	Single source of truth per topic
Current state	No historical context in main docs
Action-oriented	Every section answers "how do I...?"
Minimal	If it doesn't help users today, remove it
Scenarios for depth	Point to `scenarios/` for hands-on

Validation

Documentation is validated in CI (warn-only):

No references to removed agents
Version numbers match VERSION.md
No broken internal links
Markdown lint passes

---name: 2138-docsinstructions-58593debdescription: Standards for user-facing documentation in the docs/ folder---# Documentation StandardsInstructions for creating and maintaining user-facing documentation in the `docs/` folder.## Structure Requirements### File HeaderEvery doc file must start with:```markdown# {Title}> [Current Version](../VERSION.md) | {One-line description}```### Single H1 RuleEach file has exactly ONE H1 heading (the title). Use H2+ for all other sections.### Link Style- Use relative links for internal docs: `[Quickstart](quickstart.md)`- Use reference-style links for external URLs- No broken links (validated in CI)## Current Architecture (as of 2026-02-03)### Agents (8 total)| Agent | Purpose ||-------|---------|| `infraops-conductor` | Master orchestrator with approval gates || `requirements` | Gather infrastructure requirements || `architect` | WAF assessment and architecture design || `design` | Architecture diagrams and ADRs || `bicep-plan` | Implementation planning and governance || `bicep-code` | Bicep template generation || `deploy` | Azure deployment execution || `diagnose` | Post-deployment health diagnostics |### Skills (8 total)| Skill | Category | Purpose ||-------|----------|---------|| `azure-adr` | Document Creation | Architecture Decision Records || `azure-artifacts` | Artifact Generation | Template H2s, styling, generation rules || `azure-defaults` | Azure Conventions | Regions, naming, AVM, WAF, pricing, tags || `azure-diagrams` | Document Creation | Python architecture diagrams || `github-operations` | Workflow Automation | GitHub issues, PRs, CLI, Actions, releases || `git-commit` | Tool Integration | Commit conventions || `docs-writer` | Documentation | Repo-aware docs maintenance || `make-skill-template` | Meta | Skill creation helper |## Prohibited ReferencesDo NOT reference these removed agents/skills:- ❌ `diagram.agent.md` → Use `azure-diagrams` skill- ❌ `adr.agent.md` → Use `azure-adr` skill- ❌ `docs.agent.md` → Use `azure-artifacts` skill- ❌ `azure-workload-docs` skill → Use `azure-artifacts` skill- ❌ `azure-deployment-preflight` skill → Merged into deploy agent- ❌ `orchestration-helper` skill → Deleted (absorbed into conductor)- ❌ `github-issues` / `github-pull-requests` skills → Use `github-operations`- ❌ `gh-cli` skill → Merged into `github-operations`- ❌ `_shared/` directory → Use `azure-defaults` + `azure-artifacts` skills## Content Principles| Principle | Application ||-----------|-------------|| **DRY** | Single source of truth per topic || **Current state** | No historical context in main docs || **Action-oriented** | Every section answers "how do I...?" || **Minimal** | If it doesn't help users today, remove it || **Scenarios for depth** | Point to `scenarios/` for hands-on |## ValidationDocumentation is validated in CI (warn-only):- No references to removed agents- Version numbers match VERSION.md- No broken internal links- Markdown lint passes

Frequently asked questions

2138 Docsinstructions 58593deb