Skip to content
Skills Library
Programming · Automation

new-command-docs

/new-command-docs

This skill should be used when a new ArcKit command has been added and documentation needs updating across the repository. Triggers: update documentation for new command, update command count, add command to README, update DEPENDENCY-MATRIX, update docs/index.html, new command documentation checklist, update all docs for new command, add command to dependency matrix, update command tables, sync documentation after adding command, I added a new command what do I update, post-command documentation, new slash command docs.

Repository
arc-kit ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

This skill should be used when a new ArcKit command has been added and documentation needs updating across the repository. Triggers: update documentation for new command, update command count, add command to README, update DEPENDENCY-MATRIX, update docs/index.html, new command documentation checklist, update all docs for new command, add command to dependency matrix, update command tables, sync documentation after adding command, I added a new command what do I update, post-command documentation, new slash command docs.

Original author description

This skill should be used when a new ArcKit command has been added and documentation needs updating across the repository. Triggers: update documentation for new command, update command count, add command to README, update DEPENDENCY-MATRIX, update docs/index.html, new command documentation checklist, update all docs for new command, add command to dependency matrix, update command tables, sync documentation after adding command, I added a new command what do I update, post-command documentation, new slash command docs.

How it works

  1. Pre-flight Checks
  2. Determine the New Count
  3. Update Checklist
  4. Guide Creation
  5. Post-Update Verification
  6. Run Converter
  7. References
Original SKILL.md headings · 200 lines, 1,207 words
SKILL.md preview
---
name: new-command-docs
description: "This skill should be used when a new ArcKit command has been added and documentation needs updating across the repository. Triggers: update documentation for new command, update command count, add command to README, update DEPENDENCY-MATRIX, update docs/index.html, new command documentation checklist, update all docs for new command, add command to dependency matrix, update command tables, sync documentation after adding command, I added a new command what do I update, post-command documentation, new slash command docs."
---

# New Command Documentation Checklist

When a new ArcKit command is added, **11 files** across the repository must be updated to reflect the new command. This skill provides the complete checklist and exact patterns for each update.

## Pre-flight Checks

Before starting, verify these files exist for the new command:

1. **Command file**: `plugins/arckit-claude/commands/{name}.md` (required)
2. **Template file**: `.arckit/templates/{name}-template.md` AND `plugins/arckit-claude/templates/{name}-template.md` (required for document-generating commands, skip for utility commands like `customize`, `pages`, `trello`)
3. **Guide file**: `docs/guides/{name}.md` AND `plugins/arckit-claude/guides/{name}.md` (create if missing, see Guide Creation below)

If any required file is missing, create it before proceeding. Templates should be identical between `.arckit/templates/` and `plugins/arckit-claude/templates/`. Guides should be identical between `docs/guides/` and `plugins/arckit-claude/guides/` (except `migration.md` and `customize.md` which have path differences).

## Determine the New Count

Read the current count from `plugins/arckit-claude/.claude-plugin/plugin.json` (the `description` field contains the current count, e.g., "50 slash commands"). The new count is current + 1.

## Update Checklist

Work through these 11 files in order. For exact grep patterns, insertion formats, and line-level detail, see [references/file-locations.md](references/file-locations.md).

### 1. README.md (root)

Update **4 count locations** and add a **command table row**:

- **Line ~35**: `"all {N} commands, autonomous agents"` (Claude Code plugin section)
- **Line ~41**: `"all {N} commands, templates, scripts"` (Gemini extension section)
- **Line ~742**: `"All {N} ArcKit commands with maturity status"` (Command Reference intro)
- **Line ~995**: `"the {N}x{N} command matrix"` (Reference packs section)
- **Command table**: Add a row in the appropriate category section (Foundation, Strategic Context, Requirements & Data, Research & Strategy, Cloud Research, Data Source Discovery, Procurement, Design & Architecture, Implementation, Quality & Governance, UK Government, UK MOD, Documentation & Publishing). Insert alphabetically within the category.

**Table row format**:

```markdown
| `/arckit.{name}` | Description of what the command does | [v1](link) [v2](link) | Status |
```

Status values: `Live`, `Beta`, `Experimental`

### 2. docs/index.html

Update **8 count locations** and add an **HTML command card**. See [references/html-patterns.md](references/html-patterns.md) for the full HTML template.

Count locations (search for the old number):

- `<meta name="description">` tag (~line 6)
- `<meta property="og:description">` tag (~line 10)
- Intro paragraph "{N} AI-assisted commands" (~line 459)
- `<h2>` heading "{N} ArcKit Commands" (~line 670)
- `<span id="visible-count">` and adjacent text (~line 729): `Showing <span id="visible-count">{N}</span> of {N} commands` (TWO numbers on this line)
- Gemini CLI section "all {N} commands" (~line 1423)
- Footer "All {N} commands documented" (~line 1558)

**Important**: The `visible-count` span and its adjacent count BOTH need updating. The JavaScript filter counter uses the span, while the static text shows the total.

### 3. plugins/arckit-claude/.claude-plugin/plugin.json

Update the `description` field count:

```json
"description": "The Enterprise Architecture Governance Harness - {N} slash commands across strategy, architecture, delivery, and assurance"
```

### 4. .claude-plugin/marketplace.json (root)

Update the `description` field count:

```json
"description": "{N} slash commands across strategy, architecture, delivery, and assurance — including UK Government compliance"
```

### 5. plugins/arckit-claude/README.md

Check for any command count references and update. Look for patterns like "{N} commands" or "{N} slash commands".

### 6. docs/DEPENDENCY-MATRIX.md

This is the most complex update. See [references/dependency-matrix-format.md](references/dependency-matrix-format.md) for detailed format.

Steps:

Take every level from the command file's own MANDATORY / RECOMMENDED / OPTIONAL input lists, not from memory.

1. **Add column**: Add `| {name}` to the header row in tier order (columns follow the same order as the rows)
2. **Add cells**: Add `|  |` (empty cell) to every existing row at the same column position
3. **Fill dependencies**: In each existing command's row, fill in M/R/O if the new command consumes that command's output
4. **Add row**: Add a new row for the command, in tier order, with its dependencies on other commands
5. **Check widths**: every grid line must have the same number of `|` as the header row. The old grid drifted because each row was one cell short
6. **Update tier groupings**: Add the command to the appropriate tier section (Tier 0-15)
7. **Update critical paths**: Add to relevant workflow paths if applicable
8. **Update version section**: Bump "Commands Documented" count
9. **Add changelog entry**: Add a dated entry at the top of the Changelog section
10. **Sync the copies**: copy everything above `## Changelog` into `plugins/arckit-claude/docs/DEPENDENCY-MATRIX.md` and `extensions/arckit-{codex,copilot,opencode}/docs/DEPENDENCY-MATRIX.md`, keeping their one-paragraph Changelog pointer
11. **Update the website matrix**: add the same row and column to the `app-dep-matrix` table in `docs/commands.html`

**Changelog entry format**:

```markdown
### YYYY-MM-DD - Added {Command Name} Command
- **Added**: `/arckit.{name}` command ({N}th ArcKit command) for {description}
- **Added**: {name} row and column to dependency matrix
- **Updated**: Tier {X} {Tier Name} to include {name} command
- **Dependencies**: {dep1} (M), {dep2} (R), {dep3} (O)
- **Consumed by**: {consumer1} (M/R/O), {consumer2} (M/R/O)
```

### 7. docs/WORKFLOW-DIAGRAMS.md

If the new command fits into existing workflow paths, add it to the relevant Mermaid diagrams. See [references/dependency-matrix-format.md](references/dependency-matrix-format.md) for Mermaid node format and style colors.

Not all commands need to appear in workflow diagrams. Skip if the command is a utility (customize, pages) or doesn't fit the sequential workflow model.

### 8. docs/README.md

Add a row to the **Documentation Coverage** table and update the **coverage count**:

```markdown
| `/arckit.{name}` | [{name}.md](guides/{name}.md) | Complete |
```

Insert alphabetically or in the same position as other files in its category. Update the coverage line:

```markdown
**Coverage**: {N}/{N} commands documented (100%)
```

### 9. CLAUDE.md

Update if needed:

- **Command count references**: Search for "50 commands" or similar counts
- **Multi-instance types**: nothing to update here. Since #723 `MULTI_INSTANCE_TYPES` lives only in `config/doc-types.mjs`, which `generate-document-id.mjs` imports; adding the code there is the whole job
- **Agent System table**: If the command delegates to an agent, add it to the agent table

### 10. CHANGELOG.md (root - CLI changelog)

Add an entry under a new or existing version section:

```markdown
### Added
- `/arckit.{name}` command for {description}
```

### 11. plugins/arckit-claude/CHANGELOG.md (plugin changelog)

Add an entry under a new or existing version section:

```markdown
### Added
- `/arckit.{name}` command for {description}
```

## Guide Creation

If `docs/guides/{name}.md` doesn't exist, create one based on an existing guide as a template. Good templates to copy from:

- **Simple command**: `docs/guides/plan.md` or `docs/guides/adr.md`
- **Research command**: `docs/guides/research.md` or `docs/guides/aws-research.md`
- **Compliance command**: `docs/guides/principles-compliance.md`
- **Operations command**: `docs/guides/devops.md`

A guide should contain:

1. Title and description
2. Prerequisites (which artifacts should exist first)
3. Usage examples with sample arguments
4. What the command produces (document type, filename pattern)
5. Tips and best practices

Remember to copy the guide to both `docs/guides/` and `plugins/arckit-claude/guides/`.

## Post-Update Verification

After completing all updates, verify no old counts remain:

1. **Grep for old count**: Search the entire repo for the old number pattern (e.g., "50 commands", "50 slash commands", "50 AI-assisted"). Any remaining matches are locations you missed.
2. **Grep for new count**: Verify the new count appears in all expected locations.
3. **Check the command exists in**: README.md table, docs/index.html card, docs/DEPENDENCY-MATRIX.md row/column, docs/README.md coverage table.

```bash
# Example verification (replace 49 with old count, 50 with new count)
grep -rn "50 commands\|50 slash commands\|50 AI-assisted\|50/50" README.md docs/index.html plugins/arckit-claude/.claude-plugin/plugin.json .claude-plugin/marketplace.json docs/README.md docs/DEPENDENCY-MATRIX.md
```

## Run Converter

After all documentation updates, regenerate Codex and Gemini formats:

```bash
python scripts/converter.py
```

## References

- [references/file-locations.md](references/file-locations.md) - Exact file paths, grep patterns, and insertion points
- [references/html-patterns.md](references/html-patterns.md) - HTML command card template for docs/index.html
- [references/dependency-matrix-format.md](references/dependency-matrix-format.md) - DSM format, changelog format, Mermaid diagram format
Files in this package (4)
  • SKILL.md 10 KB
  • references/dependency-matrix-format.md 7 KB
  • references/file-locations.md 9 KB
  • references/html-patterns.md 4 KB

Versions

The database has no other skills named new-command-docs.

Database snapshot: 13.11.2026 · package version 9e1c2876a6b0 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100update-docs
    Update public documentation in docs/public/ when features or tools change. Triggers on "/update-docs", "update docs", "update documentation".
  • 100repo
    Update repository documentation (README.md, docs/, CLAUDE.md) based on session changes by dispatching the up-docs-propagate-repo sub-agent. This skill should be used when the user runs /up-docs:repo.
  • 90update-docs
    Check and update repository documentation before creating PRs/MRs. Scans for outdated docs, mermaid diagrams, README, API docs. Only runs for repos with docs.enabled=true in config.json. Use when user says "update docs", "check documentation".
  • 100docs-sync
    Audit and update Argus user-facing docs (README, docs/**/*.md, site/*.html) against the code truth. Detects version drift, command-count drift, i18n parity violations, and stale CLI examples. Use before a release, or any time the user asks to "sync docs", "update docs", "fix…
  • 100skillshare-update-docs
    Update website docs to match recent code changes, cross-validating every flag against source. Use this skill whenever the user asks to: update documentation, sync docs with code, document a new flag or command, fix stale docs, or update the README. This skill covers all…
  • 100documentation
    Documentation standards and best practices for code changes. Use when writing or reviewing documentation, adding public APIs, making user-facing changes, or checking documentation quality. Triggers on: 'use documentation mode', 'document', 'documentation', 'docstring', 'add…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.