← Back to Skills Marketplace
james-code-hash

Spec-Kit SDD

by James W · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
85
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install speckit
Description
GitHub Spec-Kit integration for Spec-Driven Development (SDD). Use when: (1) initializing a new Spec-Kit project, (2) creating/updating project constitution,...
Usage Guidance
This skill mostly does what it says, but exercise caution: (1) The included reassign script expects PAPERCLIP_API_KEY, PAPERCLIP_API_URL (and may call a local workspace path) even though the skill metadata did not declare these — confirm what secrets and endpoints you must provide before installing. (2) Verify and review the referenced GitHub repo (github.com/github/spec-kit) and the specify-cli install command before running it. (3) If you don't use Paperclip or don't want an agent able to call your issue API, do not provide PAPERCLIP_API_KEY or run the reassign script. (4) Ask the publisher to explicitly list required env vars, explain the default workspace path, and document when the script will call external endpoints; consider running the script in a sandbox first. (5) If unsure, prefer manual review of the speckit-reassign.sh script and limit any API key scope before use.
Capability Analysis
Type: OpenClaw Skill Name: speckit Version: 1.0.0 The skill bundle provides a legitimate integration for GitHub's Spec-Kit to support Spec-Driven Development (SDD) workflows. It includes instructions for the agent to manage project specifications and a bash script (scripts/speckit-reassign.sh) to interact with a local issue-tracking API (Paperclip). The installation of the 'specify-cli' tool from the official GitHub repository and the use of standard API calls are consistent with the stated purpose of the skill.
Capability Assessment
Purpose & Capability
The SKILL.md describes Spec-Kit integration and includes a specific feature for reassigning Paperclip issues, which matches the included speckit-reassign.sh script. However, the skill's metadata declares no required env vars or binaries while the script clearly depends on pnpm/paperclip CLI, curl, and access to a Paperclip API — a capability that should have been declared.
Instruction Scope
Runtime instructions and included script perform network calls (curl to PAPERCLIP_API_URL), attempt to run a project-local CLI (pnpm paperclipai) and access a filesystem workspace (default /home/openclaw/.openclaw/workspace/paperclip). SKILL.md does not document the PAPERCLIP_* env vars or the expected workspace layout, so the instructions implicitly require access to local agent workspace and secret API keys not made explicit.
Install Mechanism
There is no install spec (instruction-only), which reduces install-time risk. SKILL.md instructs using 'uv tool install specify-cli' from the GitHub repo — an external install from a GitHub source (repo referenced). That is a plausible approach for this tool, but users should verify the referenced GitHub release and trustworthiness before running the installer.
Credentials
The skill metadata lists no required environment variables, yet the script reads PAPERCLIP_WORKSPACE_DIR, PAPERCLIP_API_BASE, PAPERCLIP_API_KEY, and PAPERCLIP_API_URL (and implicitly AGENT_CONFIG is mentioned in docs). These are sensitive (API keys, base URLs) and are necessary for the reassign functionality; their absence from declared requirements is a proportionality/visibility problem and could lead to accidental credential exposure if misused.
Persistence & Privilege
The skill is not always-enabled, does not request elevated platform privileges, and does not modify other skills or global agent config. The script operates on a workspace and external API but does not request permanent presence or platform-wide configuration changes.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install speckit
  3. After installation, invoke the skill by name or use /speckit
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
GitHub Spec-Kit integration for Spec-Driven Development. Full SDD workflow (Constitution → Specify → Clarify → Plan → Tasks → Implement), CLI reference, extensions/presets system, Paperclip API integration, 30+ agent support.
Metadata
Slug speckit
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Spec-Kit SDD?

GitHub Spec-Kit integration for Spec-Driven Development (SDD). Use when: (1) initializing a new Spec-Kit project, (2) creating/updating project constitution,... It is an AI Agent Skill for Claude Code / OpenClaw, with 85 downloads so far.

How do I install Spec-Kit SDD?

Run "/install speckit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Spec-Kit SDD free?

Yes, Spec-Kit SDD is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Spec-Kit SDD support?

Spec-Kit SDD is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Spec-Kit SDD?

It is built and maintained by James W (@james-code-hash); the current version is v1.0.0.

💬 Comments