Agent skill

Sdd Workflow Skill

by sopaco in sopaco/terrain

Terrain SDD standardized workflow — requirement clarification, technical design, code generation, and code review.

MITAuto-check passedDevelopment

Install Sdd Workflow Skill

skills CLI
$ npx skills add sopaco/terrain --skill sdd-workflow-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sopaco/terrain sdd-workflow-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sopaco/terrain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/preset_skills/sdd-workflow-skill .claude/skills/sdd-workflow-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sdd-workflow-skill
GitHub stars
256
Token cost
~447 tokens
SKILL.md length
177 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Terrain SDD standardized workflow — requirement clarification, technical design, code generation, and code review.

  • Works in 4 steps: Requirement clarification… → Technical design (2.tech-design.md) → Code generation (3.implementation.md +… → …
  • Tasks that involve Code review
  • SKILL.md covers Environment, Phases and Output contract
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Sdd Workflow Skill is an agent skill from sopaco/terrain. Terrain SDD standardized workflow — requirement clarification, technical design, code generation, and code review.

Its SKILL.md is about 450 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Code review. The repository describes itself as: AI-native engineering environment management that makes your codebase agent-ready. The licence is MIT.

When your agent uses it

  • Tasks that involve Code review

Example prompts

  • “/sdd-workflow-skill”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Requirement clarification (1.requirements.md)
  2. Technical design (2.tech-design.md)
  3. Code generation (3.implementation.md + repo changes)
  4. Code review (4.code-review.md)

What it can do on your machine

Read from SKILL.md and the folder at commit 0746b38. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sdd Workflow Skill loads about 447 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 177 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~447

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sopaco/terrain at commit 0746b38, republished under its MIT licence (© sopaco). 177 words, ~447 tokens.

Download SKILL.mdSave it as .claude/skills/sdd-workflow-skill/SKILL.md (or your agent's skills folder).
name
sdd-workflow-skill
description
Terrain SDD standardized workflow — requirement clarification, technical design, code generation, and code review.

SDD Standardized Workflow

Software Design Driven (SDD) workflow for Terrain. Execute one phase at a time and persist outputs under the local SDD store (~/.terrain/sdd/{project}/sessions/{id}/outputs/).

Environment

VariablePurpose
TERRAIN_SDD_SKILLThis skill directory
TERRAIN_SDD_WORKSPACEIntermediate workspace (local session dir under ~/.terrain/sdd/)
TERRAIN_SDD_OUTPUT_DIRPhase outputs (outputs/) — not versioned in Git
TERRAIN_HUMAN_OUTPUT_DIRLitho human docs for context

Phases

Phase 1 — Requirement clarification (1.requirements.md)
  • Clarify goals, scope, user stories, acceptance criteria
  • List constraints, dependencies, and open questions
  • Do not start technical design in this phase
Phase 2 — Technical design (2.tech-design.md)
  • Read 1.requirements.md and project knowledge (human docs, agent pack)
  • Produce architecture decisions, module boundaries, APIs, data model
  • Include rollout plan and risks
Phase 3 — Code generation (3.implementation.md + repo changes)
  • Implement the approved technical design in the repository
  • Follow existing project conventions
  • Write implementation notes to 3.implementation.md
Phase 4 — Code review (4.code-review.md)
  • Compare implementation against requirements and technical design
  • Review changed files in the repository
  • Report findings: Critical / Major / Minor / Suggestions

Output contract

Write each phase artifact to TERRAIN_SDD_OUTPUT_DIR using the filenames above. Use absolute paths when writing outside the repository root.

© sopaco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in preset_skills/sdd-workflow-skill of sopaco/terrain.

Open the folder on GitHubat commit 0746b38

Compare with similar skills

Sdd Workflow Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sdd Workflow Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sdd Workflow Skill this skillsopaco/terrain256—~447Automated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Backend Code Reviewlangflow-ai/langflow156k—~3.5kAutomated safety check: NotesMIT
Understand Diff AnalysisEgonex-AI/Understand-Anything86k1 repos~1.4kAutomated safety check: PassMIT
Mole Bug Patternstw93/Mole70k—~2kAutomated safety check: PassGPL-3.0

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Backend Code Review

    langflow-ai/langflow

    Review backend code for quality, security, maintainability, and best practices based on established checklist rules.

    156k GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check: notes
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    86k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    70k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Backend Code Review

    langgenius/dify

    Reviews backend code under api/ for concrete, reproducible defects, routes to rule packs for architecture, schema, repositories and SQLAlchemy, and ranks findings from P0 to P3.

    158k GitHub stars~676 tokensUpdated today
    DevelopmentAuto-check passed

More from sopaco/terrain

  • Litho Document Skill

    sopaco/terrain

    This skill should be used when the user asks to "generate project documentation", "analyze codebase architecture", "create C4 architecture diagrams", "document a repository", "generate technical…

    256 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed
  • Generate architecture-level agent context (no code细节) for Terrain projects.

    256 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Agent Context Skill

    sopaco/terrain

    A skill your agent uses when a coding agent needs project source context from Terrain agent assets.

    256 GitHub stars~486 tokensUpdated 9 days ago
    Auto-check passed
  • Terrain Ask Skill

    sopaco/terrain

    Terrain Ask — query knowledge via terrain CLI when Agent execution mode is ACP.

    256 GitHub stars~926 tokensUpdated 9 days ago
    Auto-check passed

Categories

Questions about Sdd Workflow Skill

What does Sdd Workflow Skill do?

Terrain SDD standardized workflow — requirement clarification, technical design, code generation, and code review. Sdd Workflow Skill is an agent skill from sopaco/terrain. Terrain SDD standardized workflow — requirement clarification, technical design, code generation, and code review.

When should I use Sdd Workflow Skill?

Sdd Workflow Skill fits situations like: tasks that involve Code review.

How do I install Sdd Workflow Skill in Claude Code?

Run `npx skills add sopaco/terrain --skill sdd-workflow-skill -a claude-code`. Or copy the skill folder (preset_skills/sdd-workflow-skill in sopaco/terrain) into .claude/skills/sdd-workflow-skill in your project. Claude Code loads it when a task matches its description.

How do I install Sdd Workflow Skill in Codex?

Run `npx skills add sopaco/terrain --skill sdd-workflow-skill -a codex`. Or copy the skill folder (preset_skills/sdd-workflow-skill in sopaco/terrain) into .agents/skills/sdd-workflow-skill in your project. Codex loads it when a task matches its description.

Can I use Sdd Workflow Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sopaco/terrain --skill sdd-workflow-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sdd-workflow-skill, .gemini/skills/sdd-workflow-skill, .github/skills/sdd-workflow-skill and .opencode/skills/sdd-workflow-skill in your project.

What does Sdd Workflow Skill need to run?

SKILL.md names no scripts, command-line tools or credentials: Sdd Workflow Skill is instructions for the agent only.

Does Sdd Workflow Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sdd Workflow Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sdd Workflow Skill use?

Sdd Workflow Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sdd Workflow Skill use?

About 447 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sdd Workflow Skill?

Skills that share tags, products or a category with Sdd Workflow Skill: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Backend Code Review (langflow-ai/langflow, 156k stars) and Understand Diff Analysis (Egonex-AI/Understand-Anything, 86k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sdd Workflow Skill?

sopaco (a GitHub user) maintains it in sopaco/terrain, which has 256 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 29, 2026.

Source: sopaco/terrain on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.