# dceoy/speckit-agent-skills architecture

> Architecture diagram of the GitHub repository dceoy/speckit-agent-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dceoy/speckit-agent-skills
- Repository: https://github.com/dceoy/speckit-agent-skills

## Overview

This repository packages Spec Kit’s spec-driven development skills and exposes generated entry points for several agent runtimes. The principal workflow moves from project principles and requirements (or a baseline of existing code) through planning and task generation to implementation, with optional review and conversion utilities. The README documents the workflow and runtime mappings; no source excerpts were provided, so relationships beyond those documented are omitted.

Main entry points: [`skills/speckit-tasks/SKILL.md`](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-tasks/SKILL.md) (Tasks), [`skills/speckit-plan/SKILL.md`](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-plan/SKILL.md) (Plan), [`.specify`](https://github.com/dceoy/speckit-agent-skills/tree/main/.specify) (Spec Kit support), [`skills/speckit-specify/SKILL.md`](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-specify/SKILL.md) (Specify)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Core workflow"]
  node_constitution["Constitution<br/>[SKILL.md]"]
  node_specify["Specify<br/>[SKILL.md]"]
  node_baseline["Baseline<br/>[SKILL.md]"]
  node_clarify["Clarify<br/>[SKILL.md]"]
  node_plan["Plan<br/>[SKILL.md]"]
  node_tasks["Tasks<br/>[SKILL.md]"]
  node_implement["Implement<br/>[SKILL.md]"]
end

subgraph group_optional["Workflow utilities"]
  node_checklist["Checklist<br/>[SKILL.md]"]
  node_analyze["Analyze<br/>[SKILL.md]"]
  node_converge["Converge<br/>[SKILL.md]"]
  node_taskstoissues["Tasks to Issues<br/>[SKILL.md]"]
end

subgraph group_runtime["Agent entry points"]
  node_shared["Shared skills"]
  node_claude["Claude skills<br/>[skills]"]
  node_codex["Codex skills<br/>[skills]"]
  node_cursor["Cursor skills<br/>[skills]"]
  node_copilot["Copilot agents<br/>[agents]"]
  node_copilotprompts["Copilot prompts<br/>[prompts]"]
  node_opencode["OpenCode commands<br/>[commands]"]
  node_gemini["Gemini commands<br/>[commands]"]
end

subgraph group_infra["Spec Kit support"]
  node_specinfra["Spec Kit support<br/>[.specify]"]
end

node_user(("Project author"))

node_user -->|"invokes skill"| node_shared
node_constitution -->|"informs requirements"| node_specify
node_constitution -->|"informs baseline"| node_baseline
node_specify -->|"feeds planning"| node_plan
node_baseline -->|"feeds planning"| node_plan
node_specify -.->|"may clarify"| node_clarify
node_baseline -.->|"may clarify"| node_clarify
node_clarify -.->|"informs planning"| node_plan
node_plan -->|"generates tasks"| node_tasks
node_tasks -->|"guides implementation"| node_implement
node_tasks -.->|"may analyze"| node_analyze
node_analyze -.->|"informs implementation"| node_implement
node_tasks -.->|"may compare"| node_converge
node_converge -.->|"adds remaining work"| node_implement
node_tasks -.->|"converts tasks"| node_taskstoissues
node_specify -.->|"may check"| node_checklist
node_plan -.->|"may check"| node_checklist
node_tasks -.->|"may check"| node_checklist
node_shared -->|"exposed through"| node_claude
node_shared -->|"exposed through"| node_codex
node_user -->|"invokes skill"| node_cursor
node_user -->|"invokes agent"| node_copilot
node_user -->|"uses prompt"| node_copilotprompts
node_user -->|"invokes command"| node_opencode
node_user -->|"invokes command"| node_gemini
node_specinfra -->|"supports generated skills"| node_shared
node_specinfra -->|"supports generated agents"| node_copilot
node_specinfra -->|"supports wrappers"| node_copilotprompts
node_specinfra -->|"supports generated commands"| node_opencode

click node_constitution "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-constitution/SKILL.md"
click node_specify "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-specify/SKILL.md"
click node_baseline "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-baseline/SKILL.md"
click node_clarify "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-clarify/SKILL.md"
click node_plan "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-plan/SKILL.md"
click node_tasks "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-tasks/SKILL.md"
click node_implement "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-implement/SKILL.md"
click node_checklist "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-checklist/SKILL.md"
click node_analyze "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-analyze/SKILL.md"
click node_converge "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-converge/SKILL.md"
click node_taskstoissues "https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-taskstoissues/SKILL.md"
click node_shared "https://github.com/dceoy/speckit-agent-skills/tree/main/skills"
click node_claude "https://github.com/dceoy/speckit-agent-skills/blob/main/.claude/skills"
click node_codex "https://github.com/dceoy/speckit-agent-skills/blob/main/.agents/skills"
click node_cursor "https://github.com/dceoy/speckit-agent-skills/tree/main/.cursor/skills"
click node_copilot "https://github.com/dceoy/speckit-agent-skills/tree/main/.github/agents"
click node_copilotprompts "https://github.com/dceoy/speckit-agent-skills/tree/main/.github/prompts"
click node_opencode "https://github.com/dceoy/speckit-agent-skills/tree/main/.opencode/commands"
click node_gemini "https://github.com/dceoy/speckit-agent-skills/tree/main/.gemini/commands"
click node_specinfra "https://github.com/dceoy/speckit-agent-skills/tree/main/.specify"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_constitution,node_specify,node_baseline,node_clarify,node_plan,node_tasks,node_implement toneBlue
class node_checklist,node_analyze,node_converge,node_taskstoissues toneAmber
class node_shared,node_claude,node_codex,node_cursor,node_copilot,node_copilotprompts,node_opencode,node_gemini toneMint
class node_specinfra toneRose
class node_user toneIndigo
```

## Components

### Core workflow

- [Constitution](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-constitution/SKILL.md): `skills/speckit-constitution/SKILL.md`
- [Specify](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-specify/SKILL.md): `skills/speckit-specify/SKILL.md`
- [Baseline](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-baseline/SKILL.md): `skills/speckit-baseline/SKILL.md`
- [Clarify](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-clarify/SKILL.md): `skills/speckit-clarify/SKILL.md`
- [Plan](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-plan/SKILL.md): `skills/speckit-plan/SKILL.md`
- [Tasks](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-tasks/SKILL.md): `skills/speckit-tasks/SKILL.md`
- [Implement](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-implement/SKILL.md): `skills/speckit-implement/SKILL.md`

### Workflow utilities

- [Checklist](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-checklist/SKILL.md): `skills/speckit-checklist/SKILL.md`
- [Analyze](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-analyze/SKILL.md): `skills/speckit-analyze/SKILL.md`
- [Converge](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-converge/SKILL.md): `skills/speckit-converge/SKILL.md`
- [Tasks to Issues](https://github.com/dceoy/speckit-agent-skills/blob/main/skills/speckit-taskstoissues/SKILL.md): `skills/speckit-taskstoissues/SKILL.md`

### Agent entry points

- [Shared skills](https://github.com/dceoy/speckit-agent-skills/tree/main/skills): `skills`
- [Claude skills](https://github.com/dceoy/speckit-agent-skills/blob/main/.claude/skills): `.claude/skills`
- [Codex skills](https://github.com/dceoy/speckit-agent-skills/blob/main/.agents/skills): `.agents/skills`
- [Cursor skills](https://github.com/dceoy/speckit-agent-skills/tree/main/.cursor/skills): `.cursor/skills`
- [Copilot agents](https://github.com/dceoy/speckit-agent-skills/tree/main/.github/agents): `.github/agents`
- [Copilot prompts](https://github.com/dceoy/speckit-agent-skills/tree/main/.github/prompts): `.github/prompts`
- [OpenCode commands](https://github.com/dceoy/speckit-agent-skills/tree/main/.opencode/commands): `.opencode/commands`
- [Gemini commands](https://github.com/dceoy/speckit-agent-skills/tree/main/.gemini/commands): `.gemini/commands`

### Spec Kit support

- [Spec Kit support](https://github.com/dceoy/speckit-agent-skills/tree/main/.specify): `.specify`

### Other components

- **Project author**

## Connections

- Project author → Shared skills: invokes skill (evidence: `README.md`)
- Constitution → Specify: informs requirements (evidence: `README.md`)
- Constitution → Baseline: informs baseline (evidence: `README.md`)
- Specify → Plan: feeds planning (evidence: `README.md`)
- Baseline → Plan: feeds planning (evidence: `README.md`)
- Specify → Clarify: may clarify (evidence: `README.md`)
- Baseline → Clarify: may clarify (evidence: `README.md`)
- Clarify → Plan: informs planning (evidence: `README.md`)
- Plan → Tasks: generates tasks (evidence: `README.md`)
- Tasks → Implement: guides implementation (evidence: `README.md`)
- Tasks → Analyze: may analyze (evidence: `README.md`)
- Analyze → Implement: informs implementation (evidence: `README.md`)
- Tasks → Converge: may compare (evidence: `README.md`)
- Converge → Implement: adds remaining work (evidence: `README.md`)
- Tasks → Tasks to Issues: converts tasks (evidence: `README.md`)
- Specify → Checklist: may check (evidence: `README.md`)
- Plan → Checklist: may check (evidence: `README.md`)
- Tasks → Checklist: may check (evidence: `README.md`)
- Shared skills → Claude skills: exposed through (evidence: `README.md`)
- Shared skills → Codex skills: exposed through (evidence: `README.md`)
- Project author → Cursor skills: invokes skill (evidence: `README.md`)
- Project author → Copilot agents: invokes agent (evidence: `README.md`)
- Project author → Copilot prompts: uses prompt (evidence: `README.md`)
- Project author → OpenCode commands: invokes command (evidence: `README.md`)
- Project author → Gemini commands: invokes command (evidence: `README.md`)
- Spec Kit support → Shared skills: supports generated skills (evidence: `README.md`)
- Spec Kit support → Copilot agents: supports generated agents (evidence: `README.md`)
- Spec Kit support → Copilot prompts: supports wrappers (evidence: `README.md`)
- Spec Kit support → OpenCode commands: supports generated commands (evidence: `README.md`)