apocohq/adr
skills/adr/SKILL.md
Tracks Architecture Decision Records (ADRs) in docs/adrs/. Creates, lists, and updates ADRs following project conventions. TRIGGER when: user wants to record, review, or update an architectural decision.
$ install --global
skillsauthnpx skillsauth add apocohq/skills adrInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 5:26 PM5.1s1 file scanned
SKILL.md
- name:
- adr
- description:
- >
- TRIGGER when:
- user wants to record, review, or update an architectural decision.
- argument-hint:
- [what you'd like to do]
ADR Tracking
Manage Architecture Decision Records in docs/adrs/. Interpret $ARGUMENTS as natural language.
Creating an ADR
Ask the user for any missing information. You need at minimum: title, context, decision, and owner (@github-username).
If the decision is made → create docs/adrs/NNN-short-title.md with status Accepted.
If the decision is open → create docs/adrs/DRAFT-short-title.md with status Proposed.
Assign the next number by reading docs/adrs/index.md. Always update the index after creating a file.
Updating an ADR
Valid status transitions: Accepted, Deprecated, Superseded by ADR-NNN.
When promoting a Draft to Accepted: rename DRAFT-title.md → NNN-title.md and move the row from Drafts to Accepted in the index.
Conventions
- Accepted:
NNN-short-title.md— numbered, zero-padded to 3 digits, never reused - Drafts:
DRAFT-short-title.md— no number until accepted - Owner: the person accountable for the decision — drives it to resolution, revisits if context changes
- File names: short kebab-case, 2-3 words max
- Index:
docs/adrs/index.md— always keep in sync
Template
# ADR-NNN: Title
**Date:** YYYY-MM-DD
**Status:** Proposed | Accepted | Deprecated | Superseded by ADR-NNN
**Owner:** @github-username
## Context
What is the issue motivating this decision?
## Decision
What we decided.
## Alternatives Considered
What else was evaluated and why rejected.
## Consequences
What becomes easier or more difficult.
Related Skills
apocohq/write-a-prd
development
VerifiedTrustedCommunity
Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue after user approval. Use when user wants to write a PRD, create a product requirements document, or plan a new feature. Always present the PRD for user approval before submitting.
4SKILL.mdUpdated Apr 4, 2026
apocohq/things-morning-organizer
development
VerifiedTrustedCommunity
Morning review and prioritization of Things todos. Use this skill every morning, or whenever the user asks to review, triage, categorize, or prioritize their Things tasks. Also trigger when the user says things like 'what should I work on today', 'organize my todos', 'morning routine', or 'daily review'.
4SKILL.mdUpdated Apr 4, 2026
apocohq/review-work
testing
VerifiedTrustedCommunity
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
4SKILL.mdUpdated Apr 4, 2026
apocohq/ralph-it
tools
VerifiedTrustedCommunity
Pick and implement the next user story from a PRD GitHub issue. Analyzes merged PRs for prior work and findings, proposes a plan, implements it, and creates a PR linking back to the PRD. Use when user says "ralph it", "ralph-it", or wants to work through PRD user stories.
4SKILL.mdUpdated Apr 4, 2026