Agent skill · Documentation

spec-workflow

Use when medium-to-large changes need explicit requirements, technical design, and task planning before implementation, especially for multi-module work, unclear acceptance criteria, or architecture-heavy requests.

TencentCloudBasegithub.com/TencentCloudBaseGitHub ↗
claude-codecursorMIT
Install
npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill spec-workflow --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 5 KB
Bundled scripts: none
Version: 2.25.10
Path: config/.claude/skills/spec-workflow/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 1,066
Language: TypeScript

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

## Sibling skills (local only) Sibling CloudBase skills ship beside this skill. Use local relative paths such as `../auth-tool-cloudbase/SKILL.md`. If a referenced sibling skill file is missing from this environment, ask the user to install the full CloudBase plugin (or the missing skill). Do **not** HTTP-fetch remote skill or protocol markdown into the agent context. # Spec Workflow ## Activation Contract ### Use this first when - The request is a new feature, multi-step product change, cross-module integration, or architecture/design task. - Acceptance criteria are unclear and need to be made explicit before implementation. - The work involves multiple files, user flows, database design, or UI design that needs staged confirmation. ### Read before writing code if - You are unsure whether the task should go straight to coding or should first go through requirements, design, and task planning. - The request mentions a new page, a new system, a redesign, a workflow, or a multi-module refactor. ### Then also read - Frontend page or visual design work -> `../ui-design/SKILL.md` - Advanced data-model work -> `../data-model-creation/SKILL.md` ### Do NOT use for - Small bug fixes with cl

What's inside
Steps it walks through
  1. Sibling skills (local only)
  2. Activation Contract
  3. Use this first when
  4. Read before writing code if
  5. Then also read
  6. Do NOT use for
  7. Common mistakes / gotchas
  8. Minimal checklist
  9. When to use this skill
  10. Decision rule
  11. Use the full workflow when
  12. Skip the full workflow when
  13. Core workflow
  14. Phase 1: Requirements
More from CloudBase-AI-Toolkit
All skills →
About this skill
What does the spec-workflow skill do?

Use when medium-to-large changes need explicit requirements, technical design, and task planning before implementation, especially for multi-module work, unclear acceptance criteria, or architecture-heavy requests.

How do I install it?

Run `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill spec-workflow --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From TencentCloudBase/CloudBase-AI-Toolkit, a repository with 1,066 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going