sdlc-skills

The content layer for AI-assisted software delivery. Role-based agent personas (BA, Tech Lead, PM, devs, QA, PA), workflow skills (TDD, bugfix, code review, task completion, memory, …), and a registry that pulls proven skills from Matt Pocock, Jesse Vincent (obra/superpowers), and Paul Hudson so you don’t have to reinvent them.

Install via the npx one-shot or a native plugin manifest and use the agents + skills directly in any AI IDE (Claude Code, Cursor, Gemini CLI, GitHub Copilot CLI, Windsurf, Codex).

Architecture

flowchart TB
    subgraph sdlc["sdlc-skills — content + install resolution"]
        direction TB
        agents[/"factories/agent + skill content"/]
        skills[/"orphan skills/standalone-only content"/]
        registry[("skills.jsoncatalog: orphan + external")]
        installer(["bin/init.mjsnpx installer"])
        agents --- skills
        skills --- registry
        registry --- installer
    end

    subgraph consumers["consumers"]
        direction LR
        ides["AI IDEsClaude Code • CursorGemini CLI • Copilot CLIWindsurf"]
    end

    subgraph externals["upstream external skill sources"]
        direction LR
        ext_matt[["mattpocock/skillsskills/engineering/tdd"]]
        ext_obra[["obra/superpowersbrainstorming, debugging,verification, ..."]]
        ext_tws[["twostraws/*-Agent-SkillSwiftUI, SwiftData,Swift Testing, Concurrency"]]
        ext_msft[["microsoft/playwright-cliplaywright-cli"]]
    end

    installer ==>|fetch at install time| ext_matt
    installer ==>|fetch at install time| ext_obra
    installer ==>|fetch at install time| ext_tws
    installer ==>|fetch at install time| ext_msft

    sdlc ==>|direct install viaplugin manifest or npx| ides

(Node shapes convey grouping so colors aren’t needed: / / parallelograms for content dirs, ( ) round-ended for the installer, cylinders for the registry, [[ ]] subroutines for external sources. GitHub’s Mermaid renderer uses theme-adaptive colors in both light and dark mode.)

Agents are self-describing — each AGENT.md carries its own metadata (role, group, theme, aliases, skills, model). IDE plugin systems read it at install time. Nothing duplicated.

Most agents and skills live inside factories (factories//agents/ and factories//skills/). The top-level agents/ and skills/ directories hold only standalone-only “orphan” content: one agent (personal-assistant) and twelve skills (deep-research, delivery-monitor, gathering-context, knowledge-curation, memory, microsoft-365, obsidian-vault, tosca-automation, verifying-outcomes, visual-testing, vividus, xray-testing). skills.json registers those orphan monorepo skills and the 30 external skills fetched from upstream.

External skills (Matt Pocock’s tdd, Jesse Vincent’s brainstorming /