OpenSpec

PassAudited by ClawScan on May 13, 2026.

Overview

This instruction-only skill is coherent for OpenSpec-based project planning, with the main cautions being scoped project-file changes and persistent spec/instruction files.

This skill appears safe to install if you want OpenSpec-driven planning in repositories. Before use, make sure the OpenSpec tools available in your environment are trusted, run the workflow in the intended project directory, and review archived or generated spec files because they can influence future agent work.

Findings (4)

Artifact-based informational review of SKILL.md, metadata, install specs, static scan signals, and capability signals. ClawScan does not execute the skill or run runtime probes.

What this means

The skill can update and move OpenSpec files in the repository as part of a normal close-out workflow.

Why it was flagged

Archiving mutates project specification state and uses a yes flag, but the workflow also tells the agent to validate and avoid archiving incomplete work unless the user accepts it.

Skill content
`openspec_archive { changeName: "<change-name>", yes: true }` rolls the change's specs into the main spec set and moves the folder
Recommendation

Use it in a version-controlled project and review the change state before archiving, especially when work is incomplete.

What this means

An agent could use less-specific OpenSpec subcommands if it chooses the escape hatch.

Why it was flagged

The escape-hatch tool broadens the available OpenSpec command surface beyond the enumerated safe workflow, though it is still framed as OpenSpec-specific rather than arbitrary shell execution.

Skill content
`openspec_run` | Escape hatch for `openspec` subcommands not surfaced above
Recommendation

Prefer the named OpenSpec tools and use openspec_run only for clearly relevant OpenSpec commands after confirming the target project and intended effect.

What this means

Future sessions may rely on project-local specs and task lists when deciding what to implement next.

Why it was flagged

These persistent project files are intended to guide future agent work, so stale or tampered OpenSpec artifacts could influence later implementation decisions.

Skill content
Specs and proposals live under `openspec/` in the project. Each in-flight change gets its own folder with `proposal.md`, `specs/`, `design.md`, and `tasks.md`.
Recommendation

Review OpenSpec files in untrusted or unfamiliar repositories, and treat them as project context that should not override explicit user instructions.

What this means

This review covers the instruction files, not the external OpenSpec tool package that may execute the referenced operations.

Why it was flagged

The skill itself contains no code to install, but it relies on environment-provided OpenSpec tooling whose implementation is not included in the reviewed artifacts.

Skill content
Source: unknown; Homepage: none; No install spec — this is an instruction-only skill.
Recommendation

Use OpenSpec tools from a trusted installation source and keep them pinned or reviewed according to your normal project security practices.