create-justification
Standardizes the creation of justification documentation with unique identifiers and frontmatter.
Install
mkdir -p .claude/skills/create-justification && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/7394" && unzip -o skill.zip -d .claude/skills/create-justification && rm skill.zipInstalls to .claude/skills/create-justification
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Create a new justification file in .agents/justifications/ with a unique three-word ID, frontmatter, and formatted titleKey capabilities
- →Creates justification files in .agents/justifications/
- →Generates unique three-word identifiers
- →Applies standardized frontmatter
- →Formats document titles
How it works
The skill executes a script that creates a markdown file with a unique slug-based filename and pre-populated YAML frontmatter.
Inputs & outputs
When to use create-justification
- →Documenting system changes
- →Creating requirement justifications
About this skill
What I do
I help you create new justification files in the .agents/justifications/ directory. Each justification file gets:
- A unique three-word identifier (e.g.,
swift-emerald-river) - Frontmatter with the current date and formatted title
- Content you provide
How to use
Run the script with a slug and content:
npx tsx scripts/create-justification.ts "decision-name" "Justification content here"
Or use heredoc for multi-line content:
npx tsx scripts/create-justification.ts "decision-name" << HEREDOC
Multi-line
justification content
goes here
HEREDOC
File format
Files are created as: {three-word-id}-{slug}.md
Example: swift-emerald-river-decision-name.md
The file includes frontmatter:
---
date: 2026-01-13
title: Decision Name
---
Your content here
When to use me
Use this skill when you need to document the reasoning or justification for a decision, approach, or architectural choice. The unique ID ensures no filename conflicts, and the frontmatter provides metadata for organization.
When not to use it
- →When documenting non-decision related content
Limitations
- →Limited to the .agents/justifications/ directory
How it compares
It enforces a consistent file naming and metadata structure for audit trails rather than creating ad-hoc documentation files.
Compared to similar skills
create-justification side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| create-justification (this skill) | 1 | 5mo | Review | Beginner |
| ml-paper-writing | 48 | 6mo | Review | Advanced |
| docs-review | 10 | 7mo | No flags | Beginner |
| claude-md-improver | 21 | 6mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
ml-paper-writing
davila7
Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, reviewer guidelines, and citation verification workflows.
docs-review
metabase
Review documentation changes for compliance with the Metabase writing style guide. Use when reviewing pull requests, files, or diffs containing documentation markdown files.
claude-md-improver
anthropics
Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".
write-docs
tldraw
Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.
update-docs
vercel
This skill should be used when the user asks to "update documentation for my changes", "check docs for this PR", "what docs need updating", "sync docs with code", "scaffold docs for this feature", "document this feature", "review docs completeness", "add docs for this change", "what documentation is affected", "docs impact", or mentions "docs/", "docs/01-app", "docs/02-pages", "MDX", "documentation update", "API reference", ".mdx files". Provides guided workflow for updating Next.js documentation based on code changes.
wiki-architect
microsoft
Analyzes code repositories and generates hierarchical documentation structures with onboarding guides. Use when the user wants to create a wiki, generate documentation, map a codebase structure, or understand a project's architecture at a high level.