← Back to Skills Marketplace
Spec-First Development
by
kevdogg102396-afk
· GitHub ↗
· v1.0.0
443
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install spec-first-dev
Description
Spec-driven development workflow. Before writing any code, generates a comprehensive SPEC.md covering data models, user flows, API contracts, file structure,...
Usage Guidance
This skill is instruction-only and coherent with its purpose: it will read your project files and write SPEC.md in the project root, then wait for your explicit approval before writing implementation code. Before enabling or running it, confirm: (1) the agent's file-sandbox is limited to the intended repository/workspace so it cannot read unrelated files or secrets; (2) you are comfortable granting the agent Read/Write/Bash capabilities in that workspace (Bash can run arbitrary commands, so sandboxing matters); (3) the auto-trigger rules (phrases like 'build me') won't cause unwanted invocations in your environment. Note the SKILL.md mentions running 'Grep' but only lists 'Glob' explicitly — this is likely benign (grep can be run via Bash) but you may ask the author to clarify allowed-tools or explicit shell usage if you need stricter controls.
Capability Analysis
Type: OpenClaw Skill
Name: spec-first-dev
Version: 1.0.0
The skill is designed for a legitimate development workflow, but it requests `Bash` as an `allowed-tool` in `SKILL.md`. While the current instructions only explicitly suggest using `Grep` (a benign use case for `Bash`), granting arbitrary shell access to an AI agent is a significant security risk. This capability, even without explicit malicious instructions, makes the skill suspicious due to the potential for misuse, prompt injection, or unintended execution of harmful commands, classifying it as a vulnerability rather than intentional malice.
Capability Assessment
Purpose & Capability
Name and description match the instructions: the skill inspects a codebase, produces a SPEC.md, and waits for user approval before implementing. Required resources (none) and declared allowed-tools (Read, Write, Bash, Glob) are appropriate for a spec-generation workflow.
Instruction Scope
Instructions explicitly tell the agent to read the repository (glob/grep) and write SPEC.md to the project root, then pause for explicit user 'go' before any code creation. This is appropriate for the stated purpose. Minor inconsistency: SKILL.md refers to running 'Grep' but the allowed-tools list names 'Glob' (and 'Bash' is present so grep could be invoked via Bash). No instructions attempt to access unrelated system paths or external endpoints.
Install Mechanism
No install spec and no code files — instruction-only. Nothing will be downloaded or written to disk beyond the SPEC.md it is explicitly instructed to create in the project workspace.
Credentials
The skill requests no environment variables, credentials, or config paths. Its filesystem access (reading project files, writing SPEC.md) is proportional to its purpose.
Persistence & Privilege
always is false and the skill is user-invocable. It does not request persistent or elevated platform privileges and does not modify other skills' configuration. Autonomous invocation is allowed by platform default but not a red flag here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install spec-first-dev - After installation, invoke the skill by name or use
/spec-first-dev - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Introduces version 1.0.0 of the spec-first-dev skill.
- Enforces a spec-driven development workflow: generate a detailed SPEC.md before starting any implementation.
- Clarifies project intent, audits existing code, and creates specs covering models, flows, APIs, file structure, and edge cases.
- Requires explicit user approval of SPEC.md before any coding begins.
- Facilitates integration with task-tracking and code review processes.
- Helps prevent misaligned builds by forcing clear planning and documentation upfront.
Metadata
Frequently Asked Questions
What is Spec-First Development?
Spec-driven development workflow. Before writing any code, generates a comprehensive SPEC.md covering data models, user flows, API contracts, file structure,... It is an AI Agent Skill for Claude Code / OpenClaw, with 443 downloads so far.
How do I install Spec-First Development?
Run "/install spec-first-dev" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Spec-First Development free?
Yes, Spec-First Development is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Spec-First Development support?
Spec-First Development is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Spec-First Development?
It is built and maintained by kevdogg102396-afk (@kevdogg102396-afk); the current version is v1.0.0.
More Skills