/log-doc-issues Skill | Agent Skills

/log-doc-issues

Run documentation audit and create GitHub issues for all findings.

What This Does

Invoke /check-docs to audit documentation
Parse findings by priority (P0-P3)
Check existing issues to avoid duplicates
Create GitHub issues for each finding

This is an issue-creator. It creates work items, not fixes. Use /fix-docs to fix issues.

Process

1. Run Primitive

Invoke /check-docs skill to get structured findings.

2. Check Existing Issues

gh issue list --state open --label "domain/docs" --limit 50

3. Create Issues

For each finding:

gh issue create \
  --title "[P1] README missing Installation section" \
  --body "$(cat <<'EOF'
## Problem
README.md exists but lacks Installation section. New developers cannot set up the project.

## Impact
- Contributor onboarding blocked
- Time wasted figuring out setup
- Potential contributors give up

## Location
`README.md`

## Suggested Fix
Run `/fix-docs` or add manually:
- Prerequisites (Node version, etc.)
- Package manager commands
- Environment setup steps

---
Created by `/log-doc-issues`
EOF
)" \
  --label "priority/p1,domain/docs,type/chore"

4. Issue Format

Title: [P{0-3}] Documentation gap description

Labels:

priority/p0 | priority/p1 | priority/p2 | priority/p3
domain/docs
type/chore

Body:

## Problem
What documentation is missing or broken

## Impact
Who is affected (new devs, users, contributors)

## Location
File path or expected file location

## Suggested Fix
Skill to run or manual action

---
Created by `/log-doc-issues`

Priority Mapping

| Gap | Priority | |-----|----------| | Missing README.md | P0 | | Missing .env.example (with env vars used) | P0 | | README missing key sections | P1 | | Undocumented env vars | P1 | | Missing architecture docs | P1 | | Stale documentation (90+ days) | P2 | | Missing CONTRIBUTING.md | P2 | | Missing ADR directory | P2 | | Broken links | P2 | | Polish improvements | P3 |

Output

After running:

Documentation Issues Created:
- P0: 0
- P1: 3 (README sections, env vars)
- P2: 2 (stale docs, ADRs)
- P3: 1 (link checking)

Total: 6 issues created
View: gh issue list --label domain/docs

/check-docs - The primitive (audit only)
/fix-docs - Fix documentation gaps
/documentation - Full documentation workflow
/groom - Full backlog grooming

Agent Skills: /log-doc-issues

Install this agent skill to your local

Skill Files