Diagram Design
cathrynlavery/diagram-design
Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.
Write clear technical documentation: Markdown best practices, diagrams, API docs per DOCUMENTATIONNAMINGCONVENTION.md
Install Documentation Standards
$ npx skills add Hack23/cia --skill documentation-standards -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Hack23/cia documentation-standards --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Hack23/cia.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/documentation-standards .claude/skills/documentation-standards && rm -rf skills-srcUse ~/.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/
Install the "documentation-standards" agent skill from https://github.com/Hack23/cia/tree/master/.github/skills/documentation-standards into .claude/skills/documentation-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-standards", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Hack23/cia/tree/master/.github/skills/documentation-standardsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Hack23/cia --skill documentation-standards -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Hack23/cia documentation-standards --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hack23/cia.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/skills/documentation-standards .agents/skills/documentation-standards && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "documentation-standards" agent skill from https://github.com/Hack23/cia/tree/master/.github/skills/documentation-standards into .agents/skills/documentation-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-standards", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Hack23/cia --skill documentation-standards -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Hack23/cia documentation-standards --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hack23/cia.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/skills/documentation-standards .cursor/skills/documentation-standards && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "documentation-standards" agent skill from https://github.com/Hack23/cia/tree/master/.github/skills/documentation-standards into .cursor/skills/documentation-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-standards", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Hack23/cia.git --path .github/skills/documentation-standards--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Hack23/cia --skill documentation-standards -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Hack23/cia documentation-standards --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hack23/cia.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/skills/documentation-standards .gemini/skills/documentation-standards && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "documentation-standards" agent skill from https://github.com/Hack23/cia/tree/master/.github/skills/documentation-standards into .gemini/skills/documentation-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-standards", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Hack23/cia documentation-standardsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Hack23/cia --skill documentation-standards -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Hack23/cia.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/skills/documentation-standards .github/skills/documentation-standards && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "documentation-standards" agent skill from https://github.com/Hack23/cia/tree/master/.github/skills/documentation-standards into .github/skills/documentation-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-standards", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Hack23/cia --skill documentation-standards -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Hack23/cia documentation-standards --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hack23/cia.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/skills/documentation-standards .opencode/skills/documentation-standards && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "documentation-standards" agent skill from https://github.com/Hack23/cia/tree/master/.github/skills/documentation-standards into .opencode/skills/documentation-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-standards", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
documentation-standards- GitHub stars
- 239
- Token cost
- ~544 tokens
- SKILL.md length
- 88 words
- Files
- 1
- Skills in repo
- 78
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Write clear technical documentation: Markdown best practices, diagrams, API docs per DOCUMENTATIONNAMINGCONVENTION.md
- Tasks that involve Technical documentation
- SKILL.md covers Purpose, When to Use, Markdown Best Practices and Documentation Types, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Tasks that involve Diagrams
What it does
Documentation Standards is an agent skill from Hack23/cia. Write clear technical documentation: Markdown best practices, diagrams, API docs per DOCUMENTATIONNAMINGCONVENTION.md
Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Technical documentation and Diagrams. The repository describes itself as: Citizen Intelligence Agency. Open-source intelligence platform analyzing Swedish political activities using AI and data visualization. Tracks politicians, government… The licence is Apache-2.0.
When your agent uses it
- Tasks that involve Technical documentation
- Tasks that involve Diagrams
Example prompts
- “/documentation-standards”
What it can do on your machine
Read from SKILL.md and the folder at commit 6a9797b. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown and java).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
markdownguide.org
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
Documentation Standards loads about 544 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 88 words of instructions outside code blocks.
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); files beside SKILL.md are not scanned.
SKILL.md
The full file from Hack23/cia at commit 6a9797b, republished under its Apache-2.0 licence (© Hack23). 88 words, ~544 tokens.
Download SKILL.mdSave it as
.claude/skills/documentation-standards/SKILL.md (or your agent's skills folder).- name
- documentation-standards
- description
- Write clear technical documentation: Markdown best practices, diagrams, API docs per DOCUMENTATION_NAMING_CONVENTION.md
- license
- Apache-2.0
Documentation Standards Skill
Purpose
Maintain clear, consistent technical documentation for CIA platform.
When to Use
- ✅ Writing README files
- ✅ Creating API documentation
- ✅ Documenting architecture
- ✅ Writing user guides
Markdown Best Practices
Structure
# Title (H1 - only one per document)
## Overview (H2)
Brief description of what this document covers.
## Section 1 (H2)
Content for section 1.
### Subsection 1.1 (H3)
Detailed content.
## References
- [Link 1](url)
- [Link 2](url)Code Blocks
\`\`\`java
public class Example {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}
\`\`\`Tables
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Data 1 | Data 2 | Data 3 |Documentation Types
README.md
- Purpose and overview
- Quick start guide
- Installation instructions
- Basic usage examples
- Links to detailed docs
ARCHITECTURE.md
- System overview
- Component descriptions
- Data flow diagrams
- Technology stack
API Documentation
/**
* Retrieves a politician by their personal ID.
*
* @param personalId the Swedish personal ID (12 digits)
* @return the politician if found
* @throws ResourceNotFoundException if politician not found
* @throws IllegalArgumentException if personalId format invalid
*/
@GetMapping("/{personalId}")
public Politician getPolitician(@PathVariable String personalId) {
return service.findById(personalId);
}Naming Conventions
Files:
UPPERCASE_WITH_UNDERSCORES.mdfor major docslowercase-with-hyphens.mdfor guidesREADME.mdfor module documentation
Diagrams
Use Mermaid for diagrams:
\`\`\`mermaid
graph LR
A[User] --> B[Web App]
B --> C[Database]
B --> D[External API]
\`\`\`References
- DOCUMENTATION_NAMING_CONVENTION.md
- README.md
- Markdown Guide: https://www.markdownguide.org/
© Hack23, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .github/skills/documentation-standards of Hack23/cia.
Open the folder on GitHubat commit 6a9797b
Compare with similar skills
Documentation Standards 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Documentation Standards this skillHack23/cia | 239 | — | ~544 | Automated safety check: Pass | Apache-2.0 | |
| Diagram Designcathrynlavery/diagram-design | 44k | 1 repos | ~7.5k | Automated safety check: Pass | MIT | |
| Draw.io Diagram StudioAgents365-ai/drawio-skill | 10k | — | ~2.4k | Automated safety check: Notes | MIT | |
| Dark Architecture Diagram BuilderCocoon-AI/architecture-diagram-generator | 7.4k | 1 repos | ~2.1k | Automated safety check: Pass | MIT | |
| Pretty Mermaid Rendererimxv/Pretty-mermaid-skills | 1.5k | — | ~2k | Automated safety check: Pass | MIT | |
| Beautify GitHub Readmeoil-oil/beautify-github-readme | 1.8k | — | ~4.1k | Automated safety check: Pass | MIT |
Similar skills
Draw.io Diagram Studio
Agents365-ai/drawio-skill
Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.
Dark Architecture Diagram Builder
Cocoon-AI/architecture-diagram-generator
Creates dark-themed system, cloud, security and network architecture diagrams as self-contained HTML files with inline SVG and CSS.
Pretty Mermaid Renderer
imxv/Pretty-mermaid-skills
Writes and renders Mermaid diagrams as themed SVG, PNG or terminal ASCII and Unicode art with a bundled Node.js CLI that needs no browser.
Beautify GitHub Readme
oil-oil/beautify-github-readme
Redesign GitHub README homepages or create project-native pure SVG, hybrid SVG-composed PNG/WebP, and opt-in animated GIF assets.
Deepwiki Rs
sopaco/deepwiki-rs
AI-powered Rust documentation generation engine for comprehensive codebase analysis, C4 architecture diagrams, and automated technical documentation.
More from Hack23/cia
All 78 skills in this repoAccessibility Wcag Patterns
Hack23/cia
WCAG 2.1 AA compliance, ARIA attributes, keyboard navigation, screen reader optimization for accessible political data platforms
Advanced Data Visualization
Hack23/cia
Advanced chart types, D3.js/Vaadin Charts patterns, political data visualization, time series analysis
AI Governance
Hack23/cia
AI governance, EU AI Act compliance, OWASP LLM security, responsible AI practices for GitHub Copilot agents
API Integration
Hack23/cia
External API integration patterns, retry logic, circuit breakers, caching, rate limiting for government data APIs
AWS Cloudwatch Monitoring
Hack23/cia
AWS CloudWatch metrics, alarms, dashboards, log insights, and application monitoring for the CIA platform
AWS Security Architecture
Hack23/cia
AWS security best practices, VPC security, IAM, KMS, CloudTrail, GuardDuty for CIA platform deployment
Related
Categories
Questions about Documentation Standards
What does Documentation Standards do?
Write clear technical documentation: Markdown best practices, diagrams, API docs per DOCUMENTATIONNAMINGCONVENTION.md. Documentation Standards is an agent skill from Hack23/cia.
When should I use Documentation Standards?
Documentation Standards fits situations like: tasks that involve Technical documentation; tasks that involve Diagrams.
How do I install Documentation Standards in Claude Code?
Run `npx skills add Hack23/cia --skill documentation-standards -a claude-code`. Or copy the skill folder (.github/skills/documentation-standards in Hack23/cia) into .claude/skills/documentation-standards in your project. Claude Code loads it when a task matches its description.
How do I install Documentation Standards in Codex?
Run `npx skills add Hack23/cia --skill documentation-standards -a codex`. Or copy the skill folder (.github/skills/documentation-standards in Hack23/cia) into .agents/skills/documentation-standards in your project. Codex loads it when a task matches its description.
Can I use Documentation Standards 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 Hack23/cia --skill documentation-standards -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/documentation-standards, .gemini/skills/documentation-standards, .github/skills/documentation-standards and .opencode/skills/documentation-standards in your project.
What does Documentation Standards need to run?
SKILL.md names no scripts, command-line tools or credentials: Documentation Standards is instructions for the agent only.
Does Documentation Standards access the network?
SKILL.md names 1 domain. As links in the text: markdownguide.org. This is read from the text; nothing was executed.
Is Documentation Standards 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. Review the folder before installing.
What licence does Documentation Standards use?
Documentation Standards is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Documentation Standards use?
About 544 tokens (SKILL.md is roughly 2.2k 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 Documentation Standards?
Skills that share tags, products or a category with Documentation Standards: Diagram Design (cathrynlavery/diagram-design, 44k stars), Draw.io Diagram Studio (Agents365-ai/drawio-skill, 10k stars), Dark Architecture Diagram Builder (Cocoon-AI/architecture-diagram-generator, 7.4k stars) and Pretty Mermaid Renderer (imxv/Pretty-mermaid-skills, 1.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Documentation Standards?
Hack23 (a GitHub organization) maintains it in Hack23/cia, which has 239 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 6, 2026.
Source: Hack23/cia on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.