skills.rest
GeneralJerel
GeneralJerelCOMMUNITY
Explore all skills by this author →
GitHub

create-adr

Generate Architecture Decision Records with context, decisions, alternatives, and consequences.

6|Updated Feb 19, 2026
Search Tags:#template#documentation#adr#engineering#architecture-decision#decision-record
One-click install
npx skills add https://github.com/GeneralJerel/chalk-skills --skill create-adr-generaljerel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-adr
Source: https://github.com/GeneralJerel/chalk-skills/tree/main/skills/create-adr
Command: npx skills add https://github.com/GeneralJerel/chalk-skills --skill create-adr-generaljerel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADRs document the rationale behind technical decisions, capturing the context, constraints, and tradeoffs to guide future engineers.

Core Features & Use Cases

  • ADR generation: create well-structured records with context, decision, alternatives, and consequences.
  • Template-driven: follows a standard ADR format including revisits, status, and references.
  • Collaborative workflow: guides researching options and recording justification for architectural choices across projects.

Quick Start

Provide a brief decision context and generate the ADR file.

Frequently Asked Questions about create-adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document context and alternatives for an architecture decision?▼

Architecture Decision Records document context, alternatives, decisions, and consequences to capture rationale. This Skill automates ADR creation using a structured template to record justification for architectural choices.

What is the best way to create an Architecture Decision Record for a new project?▼

Creating an Architecture Decision Record is best handled by automating the formatting of context, alternatives, and consequences. This Skill generates well-structured records following a standard ADR format including revisits and references.

How do I update an existing Architecture Decision Record?▼

Updating an existing Architecture Decision Record requires applying changes to the context, decision, and consequences. This Skill automates updates to existing ADRs across engineering projects while maintaining the standard template structure.

What format and file path should architecture decisions be saved to?▼

Architecture Decision Records should use a structured template including Context, Decision, Alternatives, Consequences, and Revisit triggers. This Skill enforces proper ADR file naming under the .chalk/docs/engineering directory.

Do I need a specific template structure to document architectural choices?▼

Documenting architectural choices requires a structured ADR template including Context, Decision, Alternatives, Consequences, and Revisit triggers. This Skill mandates this specific format to ensure decision rationale is properly captured.

Related Skills

Explore More Software Engineering Skills→
ImLpImLp

adr

Generate ADR files in wiki/adrs/ with context, decision, and consequences.

Community
Advanced
GainInsightDevGainInsightDev

af-architecture-expertise

Create, document, and review architectural decisions using ADR methodology.

Official
Advanced
plurigridplurigrid
60

tailscale-mesh

Manage Tailscale mesh VPN networking with CLI commands for status, SSH, and file transfer.

Official
Advanced
ProjAnvilProjAnvil
3

tech-documentation

Draft API and architecture documentation using standardized templates.

Official
Intermediate