← Back to Skills Marketplace
76
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install spec-to-adr
Description
Convert agent execution plans into MADR-format Architecture Decision Records for audit trails and architecture progression. Use when the user asks to create...
Usage Guidance
This skill appears coherent and limited to creating ADR files from plans in your repository. Before installing or invoking it, consider: (1) Are you comfortable allowing the agent to read project files and write into your repo workspace? (2) Prefer running it in a branch or sandbox so generated ADRs can be reviewed before committing. (3) The tool may run git-config lookups for the user.name to populate fields—no credentials are required. (4) If your project uses a different ADR location or naming convention, confirm or provide that to the agent to avoid unexpected file writes. Finally, review any generated ADR and updated README.md before merging to ensure accuracy.
Capability Analysis
Type: OpenClaw Skill
Name: spec-to-adr
Version: 1.0.0
The 'spec-to-adr' skill is a utility designed to automate the conversion of project execution plans into Architecture Decision Records (ADRs) using the MADR format. It involves reading local markdown files (e.g., from `.planning/` or `.cursor/plans/`), extracting structured data, and writing new files to a `docs/adr/` directory. While it performs file system operations and executes a single benign command (`git config user.name`) to identify decision-makers, its behavior is entirely consistent with its stated purpose and lacks any indicators of malicious intent, data exfiltration, or unauthorized persistence.
Capability Assessment
Purpose & Capability
Name and description match the instructions: the skill locates plan files in the workspace, extracts decision content, generates ADR markdown, and updates an ADR index. No unrelated credentials, binaries, or external services are requested.
Instruction Scope
Runtime instructions operate on repository files (e.g., .planning/, .cursor/plans/, generic markdown, docs/adr/). They direct reading source plan files and writing ADR files and an index. The scope is limited to documentation/architecture artifacts and includes sensible edge-case handling (multiple decisions, superseding ADRs). The instructions do not direct data to external endpoints or request reading unrelated system secrets.
Install Mechanism
This is an instruction-only skill with no install spec and no code files to execute. That minimizes disk/installation risk.
Credentials
The skill declares no required environment variables or credentials. It suggests using the git user name (git config user.name) as a convenience, which is proportional to populating 'Decision-makers'. No secrets or unrelated tokens are requested.
Persistence & Privilege
The skill does not request always: true and does not modify other skills or global agent settings. It writes ADR files into the repository workspace (docs/adr/ or equivalent), which is appropriate for its function; persistent presence is not requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install spec-to-adr - After installation, invoke the skill by name or use
/spec-to-adr - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release: Convert execution plans into numbered MADR-format Architecture Decision Records (ADRs) for audit trails and architecture documentation.
- Supports detection and extraction from GSD phase plans, Cursor CreatePlan output, and generic markdown plans.
- Automates mapping plan content to MADR fields, handling various sources and inferring fields as needed.
- Generates and numbers ADR files using a standardized filename format and manages the ADR directory structure.
- Updates and maintains an index of all ADRs in `README.md`.
- Handles multi-decision plans, ADR superseding, sparse plans, and directory creation according to best practices.
Metadata
Frequently Asked Questions
What is Spec to ADR?
Convert agent execution plans into MADR-format Architecture Decision Records for audit trails and architecture progression. Use when the user asks to create... It is an AI Agent Skill for Claude Code / OpenClaw, with 76 downloads so far.
How do I install Spec to ADR?
Run "/install spec-to-adr" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Spec to ADR free?
Yes, Spec to ADR is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Spec to ADR support?
Spec to ADR is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Spec to ADR?
It is built and maintained by rawc0der (@rawc0der); the current version is v1.0.0.
More Skills