spec-superflow

Lean spec workflow with direct or planned execution, optional specifications, one final review by default, recoverable state, and a bundled same-version CLI runtime.

magebyte/spec-superflow · v2.0.1 · Development & Workflow

MageByteOwner verifiedreview

Trust Score

78

Security

76

Surfaces

9

What is spec-superflow?

spec-superflow is a published development & workflow plugin for AI coding agents in the codex ecosystem, developed by MageByte and distributed through the HOL AI plugin registry. Lean spec workflow with direct or planned execution, optional specifications, one final review by default, recoverable state, and a bundled same-version CLI runtime.

Canonical slug: magebyte/spec-superflow
Version: v2.0.1 · updated Sep 24, 2026
Open data: entity.json (JSON-LD)

Trust & Reputation

HOL Trust Score

78

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability

76pts

Maintenance

100pts

MCP Posture

100pts

Plugin Security

76pts

Provenance

70pts

Publisher Quality

75pts

Registry Snapshot

Repository: https://github.com/MageByte-Zero/spec-superflow
Homepage: https://github.com/MageByte-Zero/spec-superflow
Canonical profile: https://hol.org/registry/plugins/magebyte%2Fspec-superflow
Publisher verification: No
Marketplace source: Unknown
Scanner: Broker fallback
Safety label: review
Digest verified: Yes

9 bundled skills — copy or download SKILL.mdOpen skills

Trust & reputation

Trust & Reputation

HOL Trust Score

78

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability

76pts

Maintenance

100pts

MCP Posture

100pts

Plugin Security

76pts

Provenance

70pts

Publisher Quality

75pts

Provenance

Plugin root: .
Source repo: https://github.com/MageByte-Zero/spec-superflow
Source commit: 25d9b0cee199…
Publisher verified: No
Owner verified: @MageByte-Zero

Continuous scanner CI detected

No action is required. This plugin receives the full trust score.

Verified badge not detected

Add the HOL verified badge to the repository README to score +2% trust. Plugin owners can open that pull request from Guard Plugins.

Security Posture

review

Safety label

76

Security score

0

High findings

Provider: registry-broker-fallback
Grade: C · review
Version: Unknown

cisco-skill-scanner: unknown

Findings

mediumpublishabilitypublishability.link.missing.privacyPolicyURL

privacyPolicyURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.termsOfServiceURL

termsOfServiceURL should be present for marketplace readiness.

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

spec-superflow — Frequently asked questions

What is spec-superflow?: spec-superflow is an AI plugin in the HOL registry. Lean spec workflow with direct or planned execution, optional specifications, one final review by default, recoverable state, and a bundled same-version CLI runtime.
How do I install spec-superflow?: Install spec-superflow in your harness: Codex — codex plugin marketplace add MageByte-Zero/spec-superflow; Claude Code — /plugin marketplace add MageByte-Zero/spec-superflow; Cursor — npx skills add MageByte-Zero/spec-superflow. Full step-by-step guidance is on the HOL plugin page.
How do I install spec-superflow in Codex?: To install spec-superflow in Codex, start with codex plugin marketplace add MageByte-Zero/spec-superflow. The complete step-by-step install guide for Codex is on the HOL plugin page.
How do I install spec-superflow in Claude Code?: To install spec-superflow in Claude Code, start with /plugin marketplace add MageByte-Zero/spec-superflow. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
How do I install spec-superflow in Cursor?: To install spec-superflow in Cursor, start with npx skills add MageByte-Zero/spec-superflow. The complete step-by-step install guide for Cursor is on the HOL plugin page.
Is spec-superflow free?: Pricing for spec-superflow is published on its HOL plugin page when the maker schedules a launch.
Who publishes spec-superflow?: spec-superflow is published by MageByte and listed on HOL.
Is spec-superflow available now?: spec-superflow availability is listed on its HOL plugin page.

Install Guidance

Install in Claude Code

Install through the Claude Code plugin marketplace.

Claude Code plugin docs

1
Add the marketplace
Run this inside a Claude Code session.
claude code
2
Install the plugin
Use the plugin name and the marketplace name shown by the previous command.
claude code
3
Scripted alternative
Non-interactive equivalent for scripts and CI pipelines. Add --scope project to pin the install to one repository.
shell

Plugin Manifest

{
  "name": "spec-superflow",
  "version": "2.0.1",
  "description": "Lean spec workflow with direct or planned execution and evidence-based completion.",
  "author": {
    "name": "MageByte",
    "url": "https://github.com/MageByte-Zero"
  },
  "homepage": "https://github.com/MageByte-Zero/spec-superflow",
  "repository": "https://github.com/MageByte-Zero/spec-superflow",
  "license": "MIT",
  "keywords": [
    "workflow",
    "skills",
    "spec-driven-development",
    "tdd",
    "sdd",
    "contract-driven",
    "code-review",
    "debugging",
    "spec-sync",
    "codex"
  ],
  "skills": "./",
  "hooks": {},
  "interface": {
    "displayName": "spec-superflow",
    "developerName": "MageByte",
    "shortDescription": "Lean workflow with guarded completion.",
    "longDescription": "A self-contained Codex workflow with direct or planned execution, optional specifications, one final review by default, recoverable state, and delta spec sync.",
    "category": "Developer Tools",
    "composerIcon": "./assets/icon.svg",
    "capabilities": [
      "Write",
      "Review"
    ],
    "websiteURL": "https://github.com/MageByte-Zero/spec-superflow",
    "defaultPrompt": [
      "Start this change with the direct path.",
      "Create a short proposal and task list, then start planned execution.",
      "Recover the current spec-superflow change."
    ],
    "brandColor": "#2563EB"
  },
  "registryIndexVersion": 5
}

Marketplace Source

Repo URL: https://github.com/MageByte-Zero/spec-superflow
Marketplace path: Unknown
Source path: plugins/MageByte-Zero/spec-superflow
Install policy: AVAILABLE

Skills

9 SKILL.md files ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

skills-cli

bug-investigator
skills/bug-investigator/SKILL.md
Use when encountering any bug, test failure, or unexpected behavior during spec-superflow execution, before proposing fixes. Invoked automatically when build-executor hits a blockage.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
build-executor
skills/build-executor/SKILL.md
Execute an active direct request or approved planned change. Native continuous implementation is the default; existing legacy changes retain their recorded contract obligations.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
code-reviewer
skills/code-reviewer/SKILL.md
Review completed implementation batches for spec compliance and code quality. Invoke after execution batches complete, before merging, or when a review gate is reached in the workflow.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
contract-builder
skills/contract-builder/SKILL.md
Maintain an execution contract only for an existing legacy change that requires one. New direct/planned changes do not invoke this skill when a contract is absent.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
need-explorer
skills/need-explorer/SKILL.md
Clarify intent, scope, constraints, and success criteria before artifact creation. Invoke when the request is fuzzy, the user is comparing options, or the workflow needs a stable change definition before writing artifacts.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
release-archivist
skills/release-archivist/SKILL.md
Close out a spec-superflow change with verification, summary, and archive readiness. Invoke when implementation is complete, verification is underway, or the user asks for a final wrap-up.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
spec-merger
skills/spec-merger/SKILL.md
Sync delta specs to main specs before closure. Invoke while an executing change has delta specs to merge into the main spec base, or when detecting spec drift across multiple changes.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
spec-writer
skills/spec-writer/SKILL.md
Create or refine spec-superflow planning artifacts. Invoke when the change is understood well enough to write proposal.md, specs/, design.md, and tasks.md.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
workflow-start
skills/workflow-start/SKILL.md
Primary entry point for the spec-superflow state-machine workflow. Invoke only when the user explicitly requests spec-superflow or an active change contains .spec-superflow.yaml and the user asks to continue that change. Generic proposal, specs, design, task, or contract files are not activation signals.
Raw SKILL.md
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

File Inventory

.claude-plugin/plugin.json

file

664 bytes

4b813ec454ab946b…

.codex-plugin/plugin.json

plugin-manifest

1,209 bytes

456b6663758f4f75…

.cursor-plugin/marketplace.json

file

391 bytes

c6394fabf1652ad8…

.cursor-plugin/plugin.json

file

705 bytes

43b5460cf74a66be…

.opencode/plugins/spec-superflow.js

file

1,815 bytes

3c8e39fff8c2a832…

AGENTS.md

file

8,515 bytes

15fe106b29b7bcf0…

assets/icon.svg

asset

342 bytes

82d23ffeeab15bba…

commands/ssf/resume.md

file

861 bytes

b1e3c9ba7f276ae2…

commands/ssf/save.md

file

1,087 bytes

56ce3873d65fa5dd…

commands/ssf/switch.md

file

784 bytes

b75dee1f2ca08561…

gemini-extension.json

file

186 bytes

4b970ad64f618e61…

GEMINI.md

file

780 bytes

fbd781a0dad05760…

hooks/hooks-cursor.json

file

108 bytes

10bdcb867a61d5ba…

hooks/hooks.json

file

323 bytes

d76eb39dff552232…

package-lock.json

file

911 bytes

f9d54a5476f94338…

package.json

file

1,324 bytes

391757e0ff6f4c5a…

plugin.json

file

917 bytes

4ff2b076dba0c3bc…

README.md

file

11,713 bytes

6ccb660c050661f0…

SECURITY.md

file

1,328 bytes

ff40779b5f0a82dd…

skills/bug-investigator/SKILL.md

skill

6,541 bytes

509e77e10f529bbe…

skills/build-executor/implementer-prompt.md

skill

8,264 bytes

ad421227caed21f8…

skills/build-executor/re-review-prompt.md

skill

2,465 bytes

5d8fc13da936a66b…

skills/build-executor/SKILL.md

skill

9,271 bytes

ad3f7f118975fbd6…

skills/build-executor/task-reviewer-prompt.md

skill

9,989 bytes

1e764c23a8b864af…

skills/build-executor/writing-good-tests.md

skill

2,502 bytes

44b7e43d52bbe23c…

skills/code-reviewer/code-reviewer-prompt.md

skill

6,777 bytes

1027949f0ce38f9f…

skills/code-reviewer/SKILL.md

skill

6,016 bytes

5056c96e2e28dacd…

skills/contract-builder/SKILL.md

skill

5,156 bytes

9c4ef4f694a69f39…

skills/need-explorer/SKILL.md

skill

3,223 bytes

c299a3b6015b9457…

skills/release-archivist/SKILL.md

skill

5,004 bytes

6fc33647e991300e…

skills/spec-merger/SKILL.md

skill

4,796 bytes

22bc7fb83f6077a0…

skills/spec-writer/SKILL.md

skill

6,438 bytes

5029295ab08cd111…

skills/workflow-start/SKILL.md

skill

5,248 bytes

c9a55cd09dcd1816…

tsconfig.json

file

290 bytes

2928022c75f6ccf8…