Agent skill

Technical Documentation Templates

by bybren-llc in bybren-llc/safe-agentic-workflow

“Documentation templates for ADRs, runbooks, architecture docs, and knowledge transfer documents. Use when creating Architecture Decision Records, writing operational runbooks…”

— description from SKILL.md by bybren-llc
MITAuto-check passedDevelopment

Install Technical Documentation Templates

skills CLI
$ npx skills add bybren-llc/safe-agentic-workflow --skill confluence-docs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bybren-llc/safe-agentic-workflow confluence-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bybren-llc/safe-agentic-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/confluence-docs .claude/skills/confluence-docs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
confluence-docs
GitHub stars
421
Token cost
~1.2k tokens
SKILL.md length
132 words
Files
4 (incl. scripts, references, assets)
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

  • SKILL.md covers Purpose, When This Skill Applies, ADR Template (Architecture… and Runbook Template, plus 4 more sections

About this skill

“Documentation templates for ADRs, runbooks, architecture docs, and knowledge transfer documents. Use when creating Architecture Decision Records, writing operational runbooks, documenting system architecture, or creating technical specifications. Do NOT use for code implementation or ticket management.”

— description from SKILL.md by bybren-llc

Technical Documentation Templates is a skill in bybren-llc/safe-agentic-workflow (421 stars). Its SKILL.md is about 1.2k tokens, with 3 other files in the folder (scripts, references, assets). Licence: MIT.

What it can do on your machine

Read from SKILL.md and the folder at commit 26ca58b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Technical Documentation Templates loads about 1.2k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 132 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from bybren-llc/safe-agentic-workflow at commit 26ca58b, republished under its MIT licence (© bybren-llc). 132 words, ~1,245 tokens.

Download SKILL.mdSave it as .claude/skills/confluence-docs/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
confluence-docs
description
Documentation templates for ADRs, runbooks, architecture docs, and knowledge transfer documents. Use when creating Architecture Decision Records, writing operational runbooks, documenting system architecture, or creating technical specifications. Do NOT use for code implementation or ticket management.

Confluence Documentation Skill

TEMPLATE: This skill uses {{PLACEHOLDER}} tokens. Replace with your project values before use.

Purpose

Provide standardized templates for creating technical documentation. These templates ensure consistent, high-quality documentation across the project.

When This Skill Applies

  • Creating Architecture Decision Records (ADRs)
  • Writing operational runbooks
  • Documenting system architecture
  • Creating technical specifications
  • Writing knowledge transfer (KT) documents

ADR Template (Architecture Decision Record)

markdown
# ADR-XXX: [Title]

## Status
[Proposed | Accepted | Deprecated | Superseded]

## Context
What is the issue that we're seeing that motivates this decision?

## Decision
What is the change that we're proposing and/or doing?

## Consequences

### Positive
- [Benefit 1]
- [Benefit 2]

### Negative
- [Tradeoff 1]
- [Tradeoff 2]

### Neutral
- [Observation]

## Implementation Notes
How should this decision be implemented?

## Related Decisions
- ADR-XXX: [Related decision]

## References
- [Link to relevant documentation]

Runbook Template

markdown
# Runbook: [Operation Name]

## Overview
Brief description of what this runbook covers.

## Prerequisites
- [ ] Access to [system]
- [ ] Required permissions
- [ ] Tools installed

## Procedure

### Step 1: [Action Name]
[Command to execute]

**Expected output**: Description of what you should see
**If error**: What to do if something goes wrong

### Step 2: [Action Name]
...

## Verification
How to verify the operation was successful.

## Rollback
Steps to undo the operation if needed.

## Troubleshooting

### Issue: [Common problem]
**Symptoms**: What you see
**Cause**: Why it happens
**Solution**: How to fix it

## Contacts
- Primary: [Name/Role]
- Escalation: [Name/Role]

## Revision History
| Date       | Author | Changes         |
| ---------- | ------ | --------------- |
| YYYY-MM-DD | Name   | Initial version |

Architecture Document Template

markdown
# [System/Component] Architecture

## Overview
High-level description of the system/component.

## Goals and Non-Goals

### Goals
- [What this system should do]

### Non-Goals
- [What this system should NOT do]

## Architecture Diagram
[ASCII diagram or link to diagram]

## Components

### Component 1: [Name]
- **Purpose**: What it does
- **Location**: Where it lives
- **Dependencies**: What it needs

## Data Flow
How data moves through the system.

## Security Considerations
- Authentication
- Authorization (RLS)
- Data protection

## Performance Considerations
- Caching strategy
- Database optimization
- API response times

## Monitoring and Observability
- Key metrics
- Alerting thresholds
- Log locations

## Future Considerations
What might change or be improved.

## References
- Related ADRs
- External documentation

Knowledge Transfer (KT) Document Template

markdown
# KT: [Topic Name] - {{TICKET_PREFIX}}-XXX

## Summary
What was done and why it matters.

## Context
Background information needed to understand this work.

## Key Decisions Made
1. [Decision 1]: [Reasoning]
2. [Decision 2]: [Reasoning]

## Implementation Details

### What Changed
- File: `path/to/file`
  - Change description

### How It Works
Explanation of the implementation.

## Gotchas and Lessons Learned
Things that might trip up future developers.

## Testing
How to verify everything works.

## Related Tickets
- {{TICKET_PREFIX}}-XXX: [Related work]

## Future Work
What should be done next.

Documentation Output Locations

Doc TypeLocationNaming
ADRsdocs/adr/ADR-XXX-{description}.md
Runbooksdocs/runbooks/{operation}-runbook.md
Architecturedocs/architecture/{system}-architecture.md
KT Docsdocs/KT-{{TICKET_PREFIX}}-XXX-{topic}.md
Technical Docsdocs/agent-outputs/technical-docs/{{TICKET_PREFIX}}-XXX-{description}.md

Documentation Checklist

Before publishing any documentation:

  • Clear, descriptive title
  • Proper heading hierarchy (H1 > H2 > H3)
  • Code blocks with language tags
  • Links to related documents
  • Author and date included
  • No sensitive data (secrets, passwords)
  • Spell-checked
  • Markdown lint passes

© bybren-llc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references, assets) in .agents/skills/confluence-docs of bybren-llc/safe-agentic-workflow.

  • SKILL.md
  • assets/.gitkeep
  • references/.gitkeep
  • scripts/.gitkeep

Open the folder on GitHubat commit 26ca58b

Compare with similar skills

Technical Documentation Templates next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Technical Documentation Templates compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Technical Documentation Templates this skillbybren-llc/safe-agentic-workflow421—~1.2kAutomated safety check: PassMIT
Evidence-Backed Documentation Writerbgauryy/octocode949—~2kAutomated safety check: PassMIT
Technical Writingrsmdt/the-startup551—~1.3kAutomated safety check: PassMIT
Technical Documentationkid-sid/claude-spellbook189—~3.4kAutomated safety check: NotesMIT
Simplified Technical Englishathola/claude-night-market342—~2kAutomated safety check: PassMIT
Obsidian WriterAtmosphere/atmosphere3.8k—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Writes, repairs and copyedits project docs against the Google developer documentation style guide, verifying claims in the repository before stating them.

    949 GitHub stars~2k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Technical Writing

    rsmdt/the-startup

    Create architectural decision records (ADRs), system documentation, API documentation, and operational runbooks.

    551 GitHub stars~1.3k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Technical Documentation

    kid-sid/claude-spellbook

    A skill your agent uses when writing a README, documenting an API with OpenAPI, drafting a runbook for on-call engineers, authoring a technical spec or ADR, or setting up docs-as-code with…

    189 GitHub stars~3.4k tokensUpdated 2 mo ago
    DevelopmentAuto-check: notes
  • Simplified Technical English

    athola/claude-night-market

    Applies an ASD-STE100-derived register to operator and procedural text.

    342 GitHub stars~2k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Obsidian Writer

    Atmosphere/atmosphere

    Write well-formatted notes to the atmosphere-vault Obsidian knowledge base.

    3.8k GitHub stars~2.6k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Create Doc

    avibebuilder/claude-prime

    A skill your agent uses when the user wants to save knowledge as a file so others don't have to rediscover it — "turn this into a doc", "write this up", "document how X works", "we figured this out…

    120 GitHub stars~812 tokensUpdated 4 mo ago
    DevOps & CloudAuto-check passed

More from bybren-llc/safe-agentic-workflow

All 42 skills in this repo
  • Multi-Agent Coordination Template

    bybren-llc/safe-agentic-workflow

    Agent assignment matrix, blocker escalation, and TDM coordination patterns. Use when assigning work to specialist agents, managing blockers across agents…

    421 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • API Route Patterns

    bybren-llc/safe-agentic-workflow

    API route implementation patterns with RLS, validation, and error handling. Use when creating API routes, implementing CRUD endpoints, adding server-side…

    421 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Deployment SOP Checklist

    bybren-llc/safe-agentic-workflow

    Deployment workflows, pre-deploy validation, smoke testing, and rollback procedures. Use when deploying to staging or production, running smoke tests…

    421 GitHub stars~950 tokensUpdated 2 mo ago
    Auto-check passed
  • Frontend Patterns Template

    bybren-llc/safe-agentic-workflow

    Frontend patterns for modern web frameworks, component libraries, auth flows, and analytics. Use when building UI components, creating pages, implementing…

    421 GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Advanced Git Operations

    bybren-llc/safe-agentic-workflow

    Advanced git operations including rebase, bisect, cherry-pick, and conflict resolution. Use when rebasing feature branches, debugging with bisect…

    421 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Linear Ticket SOP

    bybren-llc/safe-agentic-workflow

    Ticket management best practices for Linear or equivalent project tracker. Use when creating issues, updating ticket status, attaching evidence, parsing…

    421 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about Technical Documentation Templates

How do I install Technical Documentation Templates in Claude Code?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill confluence-docs -a claude-code`. Or copy the skill folder (.agents/skills/confluence-docs in bybren-llc/safe-agentic-workflow) into .claude/skills/confluence-docs in your project. Claude Code loads it when a task matches its description.

How do I install Technical Documentation Templates in Codex?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill confluence-docs -a codex`. Or copy the skill folder (.agents/skills/confluence-docs in bybren-llc/safe-agentic-workflow) into .agents/skills/confluence-docs in your project. Codex loads it when a task matches its description.

Can I use Technical Documentation Templates in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bybren-llc/safe-agentic-workflow --skill confluence-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/confluence-docs, .gemini/skills/confluence-docs, .github/skills/confluence-docs and .opencode/skills/confluence-docs in your project.

What does Technical Documentation Templates need to run?

SKILL.md names no scripts, command-line tools or credentials: Technical Documentation Templates is instructions for the agent only.

Does Technical Documentation Templates access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Technical Documentation Templates safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Technical Documentation Templates use?

Technical Documentation Templates is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Technical Documentation Templates use?

About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Technical Documentation Templates?

Skills that share tags, products or a category with Technical Documentation Templates: Evidence-Backed Documentation Writer (bgauryy/octocode, 949 stars), Technical Writing (rsmdt/the-startup, 551 stars), Technical Documentation (kid-sid/claude-spellbook, 189 stars) and Simplified Technical English (athola/claude-night-market, 342 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Technical Documentation Templates?

bybren-llc (a GitHub organization) maintains it in bybren-llc/safe-agentic-workflow, which has 421 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on July 20, 2026.

Source: bybren-llc/safe-agentic-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.