Skip to content
Back to search

sdlc-skills

MarketplaceWorks with Claude CodeGitHub

12 SDLC skills: discovery, PRD, UX/UI, RFC, ADR, ERD, API design, security threat modeling, QA, release, an orchestrator enforcing stage gates, and a standing engineering-principles contract (SOLID, resilience, idempotency) ratified by a founding ADR.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lucianodperez--sdlc-skills/badge.svg)](/listings/lucianodperez--sdlc-skills)

HTML

<a href="/listings/lucianodperez--sdlc-skills"><img src="/api/listings/lucianodperez--sdlc-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Skills are plain folders with a `SKILL.md`; every Agent Skills Standard runtime reads them as-is.

**OpenCode** (project-level):

mkdir -p .opencode/skills
cp -R skills/* .opencode/skills/

**OpenCode** (global): copy `skills/*` to `~/.config/opencode/skills/`.

**Claude Code** (plugin — one command):

/plugin marketplace add LucianoDPerez/sdlc-skills

**Claude Code** (manual):

mkdir -p ~/.claude/skills
cp -R skills/* ~/.claude/skills/

**Codex** (verified path: project-level shared folder + AGENTS.md reference):

mkdir -p .agents/skills
cp -R skills/* .agents/skills/
# then list the skills you use in the project's AGENTS.md

**Tip**: OpenCode also reads `~/.claude/skills` and `~/.agents/skills` (project: `.claude/skills`, `.agents/skills`). One copy in `~/.claude/skills` serves both OpenCode and Claude Code; when the same skill exists in several places, project scope beats global.

**As a plugin** — this repo is conformant to the open [Agent Plugins v1.0.0 specification](https://agent-plugins.org) (root `plugin.json`, skills discovered at `skills/`):

# Claude Code
/plugin marketplace add LucianoDPerez/sdlc-skills

# Codex (marketplace manifest at .agents/plugins/marketplace.json, following the official google/skills pattern)
codex plugin marketplace add LucianoDPerez/sdlc-skills

Skills remain the portable cargo: any skills-only client consumes `skills/` directly, with no plugin support required.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 32 lines
  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "sdlc-skills",
  4. "version": "1.2.0",
  5. "description": "12 SDLC skills: discovery, PRD, UX/UI, RFC, ADR, ERD, API design, security threat modeling, QA, release, an orchestrator enforcing stage gates, and a standing engineering-principles contract (SOLID, resilience, idempotency) ratified by a founding ADR.",
  6. "owner": {
  7. "name": "LucianoDPerez"
  8. },
  9. "plugins": [
  10. {
  11. "name": "sdlc-skills",
  12. "displayName": "SDLC Skills",
  13. "description": "One perfect skill per SDLC stage — discovery to production, with stage gates and versioned artifacts.",
  14. "version": "1.2.0",
  15. "category": "Skills",
  16. "tags": [
  17. "sdlc",
  18. "discovery",
  19. "prd",
  20. "rfc",
  21. "adr",
  22. "threat-modeling",
  23. "qa",
  24. "release"
  25. ],
  26. "source": "./",
  27. "author": {
  28. "name": "LucianoDPerez"
  29. }
  30. }
  31. ]
  32. }
README.md · README · 138 lines
  1. # SDLC Skills
  2. [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
  3. [![Skills: 12](https://img.shields.io/badge/skills-12-5C4FC7)](#skills)
  4. [![Agent Skills Standard](https://img.shields.io/badge/Agent_Skills-Standard-8A2BE2)](https://agentskills.io)
  5. One perfect, self-contained skill per stage of the software development lifecycle — from discovery to production. Built for OpenCode, Claude Code, and Codex (any Agent Skills Standard runtime).
  6. ## The pipeline
  7. ```
  8. ┌── adr: any stage, significant choices only — most spawn at rfc ──┐
  9. │ │
  10. discovery ──▶ prd ──▶ ux-ui ──▶ rfc ──▶ erd ──▶ api-design ──▶ security ──▶ qa ──▶ release
  11. │
  12. └── implementation & code review (covered by your existing review skills)
  13. ```
  14. The bracket marks `adr` as a parallel lane spanning the whole pipeline — not a stage between others, and not something that originates at discovery. In practice most ADRs spawn at `rfc`; what decides is the significance rule in `skills/sdlc/references/pipeline.md` (transversal stage), never the stage itself. Implementation runs against the repo's standing contract `docs/principles.md` (`principles` skill): every RFC declares its deviations, and a deviation without a linked ADR fails review.
  15. ## Examples: every pipeline path, exercised
  16. - [`examples/vela/`](examples/vela/) — greenfield, user-facing: the full chain (discovery → PRD → UX → RFC → ADR → ERD → OpenAPI → threat model → test plan → release), each stage its own commit, every downstream artifact citing its upstream `path @ <approval sha>`.
  17. - [`examples/atlas/`](examples/atlas/) — B2B, API-only: `ux` and `erd` skipped with declared reasons (no user-facing surface, no schema change).
  18. - [`examples/bypass-webhook-timeout/`](examples/bypass-webhook-timeout/) — brownfield small change: pipeline bypassed by design; one ADR spawned on a significant choice.
  19. - [`examples/lean-solo/`](examples/lean-solo/) — solo developer, substantial feature: the lean profile — one collapsed feature doc replacing discovery+PRD+RFC.
  20. - [`examples/gate-fixture/`](examples/gate-fixture/) — a stale citation the gate MUST reject; CI asserts both outcomes on every push.
  21. Verify every passing chain yourself:
  22. ```bash
  23. for root in examples/vela examples/atlas examples/lean-solo; do
  24. bash skills/sdlc/assets/verify-gate.sh --root "$root" $(cd "$root" && find docs -type f | sort)
  25. done
  26. ```
  27. Each stage produces a versioned artifact inside the product repo, and each stage has an entry gate: the previous artifact must exist and pass its checklist before the next stage starts.
  28. ## Skills
  29. | Stage | Skill | Trigger words | Artifact |
  30. |---|---|---|---|
  31. | Orchestration | `sdlc` | SDLC, what stage, full lifecycle | routes to the right stage skill |
  32. | Discovery | `product-discovery` | discovery, user research, validate problem | `docs/discovery/<feature>.md` |
  33. | Product spec | `prd` | PRD, product requirements, user stories | `docs/prd/<feature>.md` |
  34. | UX/UI | `ux-ui` | UX, UI, wireframe, screens, views, user flow, design system | `docs/ux/<feature>.md` |
  35. | Technical design | `rfc` | RFC, technical design, architecture doc | `docs/rfc/NNNN-<slug>.md` |
  36. | Decisions | `adr` | ADR, decision record, why did we choose | `decisions/YYYY-MM-DD-<slug>.md` |
  37. | Data | `erd` | ERD, data model, database schema, migration | `docs/data-model/<feature>-erd.md` |
  38. | Contracts | `api-design` | API design, endpoints, OpenAPI | `docs/api/<service>-openapi.yaml` |
  39. | Security | `security` | threat model, STRIDE, security review | `docs/security/<feature>-threat-model.md` |
  40. | Quality | `qa` | test strategy, test plan, coverage | `docs/qa/<feature>-test-plan.md` |
  41. | Ship | `release` | release plan, go/no-go, runbook, rollback | `docs/releases/<version>.md` |
  42. | Implementation contract | `principles` | SOLID, circuit breaker, resilience, coding standards | `docs/principles.md` |
  43. ## Install
  44. Skills are plain folders with a `SKILL.md`; every Agent Skills Standard runtime reads them as-is.
  45. **OpenCode** (project-level):
  46. ```bash
  47. mkdir -p .opencode/skills
  48. cp -R skills/* .opencode/skills/
  49. ```
  50. **OpenCode** (global): copy `skills/*` to `~/.config/opencode/skills/`.
  51. **Claude Code** (plugin — one command):
  52. ```text
  53. /plugin marketplace add LucianoDPerez/sdlc-skills
  54. ```
  55. **Claude Code** (manual):
  56. ```bash
  57. mkdir -p ~/.claude/skills
  58. cp -R skills/* ~/.claude/skills/
  59. ```
  60. **Codex** (verified path: project-level shared folder + AGENTS.md reference):
  61. ```bash
  62. mkdir -p .agents/skills
  63. cp -R skills/* .agents/skills/
  64. # then list the skills you use in the project's AGENTS.md
  65. ```
  66. **Tip**: OpenCode also reads `~/.claude/skills` and `~/.agents/skills` (project: `.claude/skills`, `.agents/skills`). One copy in `~/.claude/skills` serves both OpenCode and Claude Code; when the same skill exists in several places, project scope beats global.
  67. **As a plugin** — this repo is conformant to the open [Agent Plugins v1.0.0 specification](https://agent-plugins.org) (root `plugin.json`, skills discovered at `skills/`):
  68. ```text
  69. # Claude Code
  70. /plugin marketplace add LucianoDPerez/sdlc-skills
  71. # Codex (marketplace manifest at .agents/plugins/marketplace.json, following the official google/skills pattern)
  72. codex plugin marketplace add LucianoDPerez/sdlc-skills
  73. ```
  74. Skills remain the portable cargo: any skills-only client consumes `skills/` directly, with no plugin support required.
  75. ## Principles
  76. 1. **One artifact per stage, committed to the repo.** Documents live next to the code they describe; no external wiki.
  77. 2. **Evidence before solution.** No PRD without discovery evidence, no RFC without an approved problem statement.
  78. 3. **Decisions are immutable.** ADRs are superseded, never rewritten — the "why" survives team turnover.
  79. 4. **Every stage ends in a verifiable checklist.** A stage is done when its Output Contract passes, not when the doc "looks done".
  80. 5. **Lean runtime, deep references.** Each `SKILL.md` is a small instruction contract; methodology lives in `references/`, templates in `assets/`.
  81. ## Stack lanes
  82. Stage skills are stack-agnostic; implementation lanes live inside `ux-ui` and `qa`:
  83. - **Frontend (React | Angular)**: `skills/ux-ui/references/framework-handoff.md` maps every UX component to shadcn/Radix (React) and Material/CDK (Angular); same UX spec drives both. Visual generation tools (e.g. Google Stitch) seed from the spec — generated HTML is a draft, never the deliverable.
  84. - **QA**: `skills/qa/references/pyramid-risk-gates.md` has the per-stack framework table (Vitest/RTL vs TestBed; Playwright + axe-core shared).
  85. - **Google Cloud projects**: install official `google/skills` (24.4k★, Apache-2.0) as technology-specific complement — it covers GCP services, not lifecycle stages.
  86. ## Authors & attribution
  87. Skills authored and maintained by [LucianoDPerez](https://github.com/LucianoDPerez) (frontmatter `metadata.author: luchop`). Apache-2.0 applies to this repo's text; the methodologies each skill encodes belong to their original authors:
  88. - `product-discovery` — The Mom Test (Rob Fitzpatrick); Opportunity Solution Tree (Teresa Torres)
  89. - `prd` — PRD structure (Martin Eriksson); epic splitting (Richard Lawrence); Gherkin (Cucumber/BDD)
  90. - `ux-ui` — WCAG 2.2 (W3C); iOS HIG / Material Design platform conventions
  91. - `rfc` — design-doc convention (Google design docs, Python PEPs, Rust RFCs); C4 Model (Simon Brown)
  92. - `adr` — Architectural Decision Records (Michael Nygard, 2011); MADR format
  93. - `erd` — expand-contract migration pattern
  94. - `api-design` — OpenAPI 3.1 (OpenAPI Initiative); RFC 7807 (IETF)
  95. - `security` — STRIDE (Microsoft); OWASP Top 10
  96. - `qa` — test pyramid (Mike Cohn); Session-Based Test Management (Kaner/Bach)
  97. - `release` — SRE practices and blameless postmortems (Google SRE)
  98. ## Maintenance
  99. - Normative format rules: `docs/skill-style-guide.md`.
  100. - Audit and refactor skills with `skill-improver`; register new skills in `AGENTS.md`.
  101. ## License
  102. Apache-2.0 (individual skills may carry their own license in frontmatter).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.