← Back to Skills Marketplace
260
Downloads
1
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install spec-writer
Description
Generate structured implementation spec documents for coding projects or features. Use when a user provides a requirement, feature idea, bug description, or...
Usage Guidance
This skill appears coherent and limited to its stated purpose, but review a few operational points before enabling it: 1) Confirm the agent is only allowed to read the intended project directory — the SKILL.md phrase 'collect information from available sources' is broad and could permit scanning unrelated files if not constrained. 2) If you expect the skill to fetch private GitHub issues, provide explicit tokens or paste the issue content yourself — the skill doesn't request credentials, so automatic fetching of private resources won't work unless the agent/platform already has access. 3) Review any generated SPEC.md before handing it to coding agents to ensure it contains no sensitive snippets copied from the repo. 4) If you allow autonomous invocation, consider limiting its workspace/network permissions so the agent can only access the repo and services you intend.
Capability Analysis
Type: OpenClaw Skill
Name: spec-writer
Version: 1.0.0
The spec-writer skill is a legitimate utility designed to generate structured implementation specification documents (Markdown) for coding projects. It gathers context from local project files (e.g., package.json, README.md) and user input to populate a comprehensive template (references/spec-template.md). The skill includes explicit safety boundaries, such as instructions to never commit secrets or API keys, and lacks any indicators of data exfiltration, malicious execution, or obfuscation.
Capability Assessment
Purpose & Capability
The name and description match the instructions: generating structured implementation specs. The runtime instructions only ask for project context (package.json, README, architecture docs, CI config, etc.) and external references when provided — all of which are reasonable for producing a useful spec.
Instruction Scope
The instructions authorize the agent to 'collect information from available sources' and to read project files and docs if accessible, then save SPEC.md in the project. This is appropriate for a spec generator, but broad phrasing could let an agent scan more of the workspace than strictly necessary. It does not instruct reading unrelated system files or exfiltrating data, but you should confirm scope (limit to project directory) before allowing autonomous runs.
Install Mechanism
No install spec and no code files are provided. Being instruction-only means nothing is written to disk by the skill itself beyond the spec it is asked to create at runtime.
Credentials
The skill requests no environment variables, credentials, or config paths. It mentions fetching GitHub issue details only 'if referenced' — fetching private issues would require credentials, but the skill does not declare or request any tokens itself.
Persistence & Privilege
always:false and no requests to modify other skills or global agent settings. The skill instructs saving a SPEC.md in the project (expected behavior) and does not demand permanent presence or elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install spec-writer - After installation, invoke the skill by name or use
/spec-writer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: structured implementation spec generator for AI coding agents
Metadata
Frequently Asked Questions
What is Spec Writer?
Generate structured implementation spec documents for coding projects or features. Use when a user provides a requirement, feature idea, bug description, or... It is an AI Agent Skill for Claude Code / OpenClaw, with 260 downloads so far.
How do I install Spec Writer?
Run "/install spec-writer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Spec Writer free?
Yes, Spec Writer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Spec Writer support?
Spec Writer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Spec Writer?
It is built and maintained by lgYanami (@lgyanami); the current version is v1.0.0.
More Skills