agents-united 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (236) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +673 -0
  3. package/dist/cli.d.ts +5 -0
  4. package/dist/cli.js +4789 -0
  5. package/dist/cli.js.map +1 -0
  6. package/package.json +77 -0
  7. package/registry/agents/orchestrator-business.md +188 -0
  8. package/registry/agents/orchestrator-design.md +168 -0
  9. package/registry/agents/orchestrator-engineering.md +183 -0
  10. package/registry/agents/orchestrator-marketing.md +228 -0
  11. package/registry/agents/orchestrator-research.md +196 -0
  12. package/registry/agents/orchestrator-security.md +190 -0
  13. package/registry/agents/orchestrator-system-architecture.md +171 -0
  14. package/registry/agents/orchestrator-universal.md +168 -0
  15. package/registry/agents/subagent-accessibility-lead.md +47 -0
  16. package/registry/agents/subagent-ai-model-architect.md +97 -0
  17. package/registry/agents/subagent-android-architect.md +47 -0
  18. package/registry/agents/subagent-appsec-penetration-tester.md +189 -0
  19. package/registry/agents/subagent-backend-architect.md +360 -0
  20. package/registry/agents/subagent-business-panel-experts.md +126 -0
  21. package/registry/agents/subagent-cloud-infrastructure-architect.md +126 -0
  22. package/registry/agents/subagent-cloud-security-architect.md +221 -0
  23. package/registry/agents/subagent-code-reviewer.md +193 -0
  24. package/registry/agents/subagent-compliance-grc-specialist.md +147 -0
  25. package/registry/agents/subagent-cross-platform-specialist.md +47 -0
  26. package/registry/agents/subagent-data-engineer.md +46 -0
  27. package/registry/agents/subagent-database-administrator.md +141 -0
  28. package/registry/agents/subagent-deep-research.md +94 -0
  29. package/registry/agents/subagent-design-ops-lead.md +121 -0
  30. package/registry/agents/subagent-design-researcher.md +133 -0
  31. package/registry/agents/subagent-design-systems-architect.md +134 -0
  32. package/registry/agents/subagent-designer-toolkit-expert.md +363 -0
  33. package/registry/agents/subagent-devops-engineer.md +423 -0
  34. package/registry/agents/subagent-distributed-systems-architect.md +47 -0
  35. package/registry/agents/subagent-e2e-tester.md +60 -0
  36. package/registry/agents/subagent-financial-analyst.md +119 -0
  37. package/registry/agents/subagent-finops-cost-engineer.md +98 -0
  38. package/registry/agents/subagent-frontend-architect.md +368 -0
  39. package/registry/agents/subagent-interaction-designer.md +302 -0
  40. package/registry/agents/subagent-ios-architect.md +46 -0
  41. package/registry/agents/subagent-legal-contract-analyst.md +108 -0
  42. package/registry/agents/subagent-lifecycle-email-specialist.md +46 -0
  43. package/registry/agents/subagent-literature-patent-analyst.md +78 -0
  44. package/registry/agents/subagent-market-intelligence-analyst.md +110 -0
  45. package/registry/agents/subagent-marketing-campaign-specialist.md +80 -0
  46. package/registry/agents/subagent-marketing-content-strategist.md +184 -0
  47. package/registry/agents/subagent-marketing-conversion-specialist.md +79 -0
  48. package/registry/agents/subagent-marketing-creative-designer.md +93 -0
  49. package/registry/agents/subagent-marketing-growth-strategist.md +137 -0
  50. package/registry/agents/subagent-ml-platform-engineer.md +95 -0
  51. package/registry/agents/subagent-operations-strategist.md +85 -0
  52. package/registry/agents/subagent-paid-acquisition-specialist.md +47 -0
  53. package/registry/agents/subagent-plg-strategist.md +46 -0
  54. package/registry/agents/subagent-prototype-tester.md +140 -0
  55. package/registry/agents/subagent-qa-automation-lead.md +63 -0
  56. package/registry/agents/subagent-repo-index.md +180 -0
  57. package/registry/agents/subagent-security-engineer.md +134 -0
  58. package/registry/agents/subagent-seo-specialist.md +46 -0
  59. package/registry/agents/subagent-socratic-mentor.md +105 -0
  60. package/registry/agents/subagent-statistical-analyst.md +132 -0
  61. package/registry/agents/subagent-sysops-sre-lead.md +84 -0
  62. package/registry/agents/subagent-system-architect.md +122 -0
  63. package/registry/agents/subagent-ui-designer.md +149 -0
  64. package/registry/agents/subagent-ux-strategist.md +88 -0
  65. package/registry/bundles.json +1386 -0
  66. package/registry/rules/AGENTS.md +41 -0
  67. package/registry/rules/CLAUDE.md +12 -0
  68. package/registry/rules/CURSOR.md +12 -0
  69. package/registry/rules/GEMINI.md +41 -0
  70. package/registry/rules/clean-code-and-architecture.md +25 -0
  71. package/registry/rules/domain-modeling-and-adr.md +27 -0
  72. package/registry/rules/git-guardrails.md +19 -0
  73. package/registry/rules/multi-agent-coordination.md +33 -0
  74. package/registry/rules/quality-aesthetics-accessibility.md +29 -0
  75. package/registry/rules/skill-attribution.md +27 -0
  76. package/registry/rules/test-driven-development.md +41 -0
  77. package/registry/skills/ab-test-setup/SKILL.md +150 -0
  78. package/registry/skills/accessibility-audit/SKILL.md +150 -0
  79. package/registry/skills/ad-attribution-modeling/SKILL.md +206 -0
  80. package/registry/skills/ad-creative-design/SKILL.md +27 -0
  81. package/registry/skills/ai-prototype-refactoring/SKILL.md +29 -0
  82. package/registry/skills/architecture-design/SKILL.md +141 -0
  83. package/registry/skills/azure-infrastructure-bicep/SKILL.md +28 -0
  84. package/registry/skills/backend-api-design/SKILL.md +151 -0
  85. package/registry/skills/chaos-engineering/SKILL.md +41 -0
  86. package/registry/skills/churn-prevention-playbook/SKILL.md +181 -0
  87. package/registry/skills/ci-cd-pipeline-automation/SKILL.md +40 -0
  88. package/registry/skills/clickable-prototype-spec/SKILL.md +150 -0
  89. package/registry/skills/code-refactoring/SKILL.md +135 -0
  90. package/registry/skills/component-library-management/SKILL.md +150 -0
  91. package/registry/skills/component-playground-setup/SKILL.md +150 -0
  92. package/registry/skills/content-calendar-strategy/SKILL.md +150 -0
  93. package/registry/skills/conversion-funnel-optimization/SKILL.md +150 -0
  94. package/registry/skills/copywriting-frameworks/SKILL.md +150 -0
  95. package/registry/skills/database-design/SKILL.md +135 -0
  96. package/registry/skills/dependency-management/SKILL.md +142 -0
  97. package/registry/skills/design-handoff-spec/SKILL.md +150 -0
  98. package/registry/skills/design-ops-workflow/SKILL.md +150 -0
  99. package/registry/skills/design-system-governance/SKILL.md +150 -0
  100. package/registry/skills/design-system-tokens/SKILL.md +150 -0
  101. package/registry/skills/design-tokens-management/SKILL.md +150 -0
  102. package/registry/skills/design-version-control/SKILL.md +150 -0
  103. package/registry/skills/diagnosing-bugs/SKILL.md +45 -0
  104. package/registry/skills/docker-deployment/SKILL.md +144 -0
  105. package/registry/skills/domain-modeling/SKILL.md +52 -0
  106. package/registry/skills/email-drip-sequences/SKILL.md +181 -0
  107. package/registry/skills/email-marketing-automation/SKILL.md +150 -0
  108. package/registry/skills/finishing-a-development-branch/SKILL.md +132 -0
  109. package/registry/skills/frontend-component-design/SKILL.md +153 -0
  110. package/registry/skills/git-guardrails/SKILL.md +41 -0
  111. package/registry/skills/google-ads-optimization/SKILL.md +27 -0
  112. package/registry/skills/graphql-schema-design/SKILL.md +146 -0
  113. package/registry/skills/grill-me/SKILL.md +57 -0
  114. package/registry/skills/grill-with-docs/SKILL.md +84 -0
  115. package/registry/skills/growth-experiment-design/SKILL.md +150 -0
  116. package/registry/skills/handoff/SKILL.md +44 -0
  117. package/registry/skills/hf-model-evaluation/SKILL.md +84 -0
  118. package/registry/skills/interaction-pattern-library/SKILL.md +150 -0
  119. package/registry/skills/interactive-prototype-builder/SKILL.md +157 -0
  120. package/registry/skills/local-llm-inference/SKILL.md +77 -0
  121. package/registry/skills/maestro-mobile-testing/SKILL.md +40 -0
  122. package/registry/skills/marketing-creative-design/SKILL.md +186 -0
  123. package/registry/skills/mcp-setup/SKILL.md +370 -0
  124. package/registry/skills/meta-ad-creative-testing/SKILL.md +26 -0
  125. package/registry/skills/micro-interaction-design/SKILL.md +150 -0
  126. package/registry/skills/microservices-architecture/SKILL.md +141 -0
  127. package/registry/skills/mobile-android-design/SKILL.md +40 -0
  128. package/registry/skills/mobile-first-design/SKILL.md +150 -0
  129. package/registry/skills/mobile-ios-design/SKILL.md +40 -0
  130. package/registry/skills/mobile-platform-offline-validate/SKILL.md +41 -0
  131. package/registry/skills/modal-serverless-python/SKILL.md +81 -0
  132. package/registry/skills/onboarding-cro/SKILL.md +185 -0
  133. package/registry/skills/paid-acquisition-ppc/SKILL.md +171 -0
  134. package/registry/skills/performance-optimization/SKILL.md +141 -0
  135. package/registry/skills/playwright-best-practices/SKILL.md +39 -0
  136. package/registry/skills/product-launch-playbook/SKILL.md +150 -0
  137. package/registry/skills/programmatic-seo/SKILL.md +213 -0
  138. package/registry/skills/rag-vector-pipeline/SKILL.md +84 -0
  139. package/registry/skills/react-best-practices/SKILL.md +40 -0
  140. package/registry/skills/receiving-code-review/SKILL.md +130 -0
  141. package/registry/skills/replicate-model-inference/SKILL.md +76 -0
  142. package/registry/skills/requesting-code-review/SKILL.md +137 -0
  143. package/registry/skills/responsive-design-audit/SKILL.md +150 -0
  144. package/registry/skills/runpod-gpu-orchestration/SKILL.md +85 -0
  145. package/registry/skills/schema-markup-strategy/SKILL.md +194 -0
  146. package/registry/skills/security-audit/SKILL.md +139 -0
  147. package/registry/skills/seo-audit/SKILL.md +150 -0
  148. package/registry/skills/signup-flow-cro/SKILL.md +150 -0
  149. package/registry/skills/social-media-campaign/SKILL.md +150 -0
  150. package/registry/skills/state-driven-ui-animation/SKILL.md +150 -0
  151. package/registry/skills/subagent-driven-development/SKILL.md +135 -0
  152. package/registry/skills/supabase-backend-architecture/SKILL.md +28 -0
  153. package/registry/skills/systematic-debugging/SKILL.md +138 -0
  154. package/registry/skills/technical-documentation/SKILL.md +136 -0
  155. package/registry/skills/technical-seo-audit/SKILL.md +27 -0
  156. package/registry/skills/telemetry-monitoring/SKILL.md +40 -0
  157. package/registry/skills/test-driven-development/SKILL.md +135 -0
  158. package/registry/skills/to-spec/SKILL.md +48 -0
  159. package/registry/skills/to-tickets/SKILL.md +47 -0
  160. package/registry/skills/turso-distributed-sqlite/SKILL.md +27 -0
  161. package/registry/skills/ui-component-spec/SKILL.md +150 -0
  162. package/registry/skills/usability-testing-protocol/SKILL.md +150 -0
  163. package/registry/skills/user-flow-mapping/SKILL.md +150 -0
  164. package/registry/skills/user-journey-mapping/SKILL.md +150 -0
  165. package/registry/skills/vector-database-design/SKILL.md +84 -0
  166. package/registry/skills/vercel-deploy-best-practices/SKILL.md +28 -0
  167. package/registry/skills/viral-referral-loops/SKILL.md +209 -0
  168. package/registry/workflows/workflow-agency-ad-creative-sprint.md +50 -0
  169. package/registry/workflows/workflow-agency-brand-design-system.md +50 -0
  170. package/registry/workflows/workflow-agency-client-pitch-proposal.md +50 -0
  171. package/registry/workflows/workflow-agency-cro-funnel-teardown.md +50 -0
  172. package/registry/workflows/workflow-agency-full-campaign.md +58 -0
  173. package/registry/workflows/workflow-agency-seo-content-engine.md +50 -0
  174. package/registry/workflows/workflow-analyze.md +60 -0
  175. package/registry/workflows/workflow-api-contract-design.md +48 -0
  176. package/registry/workflows/workflow-app-store-release.md +48 -0
  177. package/registry/workflows/workflow-brainstorm.md +60 -0
  178. package/registry/workflows/workflow-build.md +60 -0
  179. package/registry/workflows/workflow-business-panel.md +60 -0
  180. package/registry/workflows/workflow-cleanup.md +60 -0
  181. package/registry/workflows/workflow-deploy-staging.md +49 -0
  182. package/registry/workflows/workflow-design-code.md +60 -0
  183. package/registry/workflows/workflow-design-ops--handoff.md +60 -0
  184. package/registry/workflows/workflow-design-ops--plan-sprint.md +60 -0
  185. package/registry/workflows/workflow-design-ops--setup-workflow.md +60 -0
  186. package/registry/workflows/workflow-design-orchestrate.md +60 -0
  187. package/registry/workflows/workflow-design-systems--audit-system.md +60 -0
  188. package/registry/workflows/workflow-design-systems--create-component.md +60 -0
  189. package/registry/workflows/workflow-design-systems--tokenize.md +60 -0
  190. package/registry/workflows/workflow-diagnose.md +45 -0
  191. package/registry/workflows/workflow-e2e-testing.md +49 -0
  192. package/registry/workflows/workflow-email-drip-sequence.md +65 -0
  193. package/registry/workflows/workflow-estimate.md +60 -0
  194. package/registry/workflows/workflow-explain.md +60 -0
  195. package/registry/workflows/workflow-frontend-audit.md +49 -0
  196. package/registry/workflows/workflow-git.md +60 -0
  197. package/registry/workflows/workflow-grill.md +51 -0
  198. package/registry/workflows/workflow-implement.md +61 -0
  199. package/registry/workflows/workflow-incident-triage.md +49 -0
  200. package/registry/workflows/workflow-interaction-design--design-interaction.md +60 -0
  201. package/registry/workflows/workflow-interaction-design--error-flow.md +60 -0
  202. package/registry/workflows/workflow-interaction-design--map-states.md +60 -0
  203. package/registry/workflows/workflow-marketing-audit.md +60 -0
  204. package/registry/workflows/workflow-marketing-campaign-builder.md +60 -0
  205. package/registry/workflows/workflow-marketing-content-pipeline.md +60 -0
  206. package/registry/workflows/workflow-marketing-growth-experiment.md +60 -0
  207. package/registry/workflows/workflow-marketing-launch.md +60 -0
  208. package/registry/workflows/workflow-marketing-panel.md +60 -0
  209. package/registry/workflows/workflow-ml-eval.md +51 -0
  210. package/registry/workflows/workflow-mobile-build.md +49 -0
  211. package/registry/workflows/workflow-onboarding-funnel-cro.md +65 -0
  212. package/registry/workflows/workflow-paid-acquisition-campaign.md +65 -0
  213. package/registry/workflows/workflow-paid-campaign-launch.md +47 -0
  214. package/registry/workflows/workflow-plan.md +60 -0
  215. package/registry/workflows/workflow-prototyping-testing--evaluate.md +60 -0
  216. package/registry/workflows/workflow-prototyping-testing--experiment.md +60 -0
  217. package/registry/workflows/workflow-prototyping-testing--prototype-plan.md +60 -0
  218. package/registry/workflows/workflow-prototyping-testing--test-plan.md +60 -0
  219. package/registry/workflows/workflow-rag-pipeline-deploy.md +53 -0
  220. package/registry/workflows/workflow-recommend.md +60 -0
  221. package/registry/workflows/workflow-research.md +60 -0
  222. package/registry/workflows/workflow-review.md +60 -0
  223. package/registry/workflows/workflow-seo-audit-pipeline.md +47 -0
  224. package/registry/workflows/workflow-seo-content-pipeline.md +65 -0
  225. package/registry/workflows/workflow-serverless-gpu-deploy.md +52 -0
  226. package/registry/workflows/workflow-spec-panel.md +60 -0
  227. package/registry/workflows/workflow-spec.md +44 -0
  228. package/registry/workflows/workflow-test.md +60 -0
  229. package/registry/workflows/workflow-troubleshoot.md +60 -0
  230. package/registry/workflows/workflow-ui-design--color-palette.md +60 -0
  231. package/registry/workflows/workflow-ui-design--design-screen.md +60 -0
  232. package/registry/workflows/workflow-ui-design--responsive-audit.md +60 -0
  233. package/registry/workflows/workflow-ui-design--type-system.md +60 -0
  234. package/registry/workflows/workflow-ux-strategy--benchmark.md +60 -0
  235. package/registry/workflows/workflow-ux-strategy--frame-problem.md +60 -0
  236. package/registry/workflows/workflow-ux-strategy--strategize.md +60 -0
@@ -0,0 +1,150 @@
1
+ ---
2
+ name: design-system-governance
3
+ description: Production-grade Design System Governance playbook for design
4
+ operations, UX systems, and growth strategy.
5
+ metadata:
6
+ author: agents-united
7
+ version: 2.0.0
8
+ icon: ⚖️
9
+ disable-slash-command: true
10
+ ---
11
+
12
+ # Design System Governance
13
+
14
+ ## Overview & Purpose
15
+ The Design System Governance skill provides a deterministic framework for executing design system governance processes in modern software products.
16
+
17
+ Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
18
+
19
+ ## Execution Triggers & Prerequisites
20
+ ### Execution Triggers
21
+ - Direct request to execute Design System Governance tasks.
22
+ - Auditing existing product assets or workflows.
23
+ - Standardizing design-system-governance procedures across team projects.
24
+ - Preparing design handoffs or growth campaign launches.
25
+
26
+ ### Prerequisites
27
+ - Project workspace configured with design system tokens or component libraries.
28
+ - Target UI design specification or growth experiment hypothesis.
29
+ - Testing and linting tools operational.
30
+ - Clean git working directory.
31
+
32
+ ## Input & Output Requirements
33
+ ### Inputs
34
+ | Parameter | Type | Required | Description |
35
+ |---|---|---|---|
36
+ | `target_scope` | String | Yes | Target UI component, page, or campaign scope |
37
+ | `config` | Object | Optional | Specific parameters and threshold configurations |
38
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
39
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
40
+
41
+ ### Outputs
42
+ | Artifact | Path / Format | Description |
43
+ |---|---|---|
44
+ | Specification Document | `docs/design-system-governance/spec.md` | Full specification and guidelines document |
45
+ | Component / Asset Files | `src/design-system-governance/*` | Implemented design tokens, components, or campaign assets |
46
+ | Audit Report | `reports/design-system-governance/summary.json` | Health check and audit metric results |
47
+
48
+ ## Step-by-Step Execution Runbook
49
+
50
+ ### Phase 1: Pre-Execution Discovery & Workspace Analysis
51
+ 1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
52
+ ```bash
53
+ find src/ docs/ -maxdepth 3 -type f
54
+ ```
55
+ 2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
56
+ 3. Establish baseline quality metrics and target benchmarks.
57
+ 4. Verify working tree status to ensure clean git workspace.
58
+ ```bash
59
+ git status --short
60
+ ```
61
+ 5. Formulate initial execution plan.
62
+
63
+ ### Phase 2: Input Contract Validation & Strategy Selection
64
+ 1. Validate input parameters against technical feasibility and design system guidelines.
65
+ 2. Select implementation pattern matching component or campaign architecture.
66
+ 3. Establish verification rules and accessibility / conversion thresholds.
67
+ 4. Formulate atomic step-by-step execution sequence.
68
+ 5. Create temporary working directory if needed.
69
+
70
+ ### Phase 3: Core Step-by-Step Implementation Execution
71
+ 1. Author primary specification document at `docs/design-system-governance/spec.md`.
72
+ 2. Generate code, token, or layout implementation files.
73
+ ```bash
74
+ npm run typecheck
75
+ ```
76
+ 3. Apply automated formatting and linting tools.
77
+ 4. Execute unit or visual regression tests.
78
+ ```bash
79
+ npm test
80
+ ```
81
+ 5. Refactor asset structure for optimal performance and maintainability.
82
+
83
+ ### Phase 4: Verification, Testing & Quality Gate Checking
84
+ 1. Run full project verification suite.
85
+ ```bash
86
+ npm run typecheck && npm test && npm run build
87
+ ```
88
+ 2. Verify zero lint errors, type warnings, or broken references.
89
+ 3. Execute CLI health doctor check.
90
+ ```bash
91
+ node dist/cli.js doctor
92
+ ```
93
+ 4. Assert all acceptance criteria are satisfied.
94
+
95
+ ### Phase 5: Post-Execution Cleanup & Artifact Generation
96
+ 1. Generate execution summary report at `reports/design-system-governance/summary.md`.
97
+ 2. Clean up temporary build artifacts and scratch files.
98
+ 3. Commit generated files to git repository.
99
+ ```bash
100
+ git add docs/design-system-governance/ reports/design-system-governance/
101
+ git commit -m "feat(design-system-governance): implement Design System Governance playbook artifacts"
102
+ ```
103
+ 4. Publish documentation for team review.
104
+
105
+ ## Code & Configuration Exemplars
106
+
107
+ ### Exemplar 1: Design System Governance Configuration Specification
108
+ ```yaml
109
+ version: "2.0.0"
110
+ metadata:
111
+ skill: "design-system-governance"
112
+ author: "agents-united"
113
+ rules:
114
+ strictValidation: true
115
+ reporting:
116
+ format: "json"
117
+ output: "reports/design-system-governance/summary.json"
118
+ ```
119
+
120
+ ### Exemplar 2: Design System Governance Helper Module
121
+ ```typescript
122
+ export function runDesignSystemGovernance(scope: string): boolean {
123
+ console.log('Running Design System Governance on:', scope);
124
+ return true;
125
+ }
126
+ ```
127
+
128
+ ## Edge Cases & Error Recovery Procedures
129
+
130
+ ### Scenario A: Validation Failure in Design System Governance
131
+ 1. **Diagnosis**: Specification or code asset fails validation rules in design-system-governance.
132
+ 2. **Recovery Protocol**:
133
+ - Step 1: Inspect error log at reports directory.
134
+ - Step 2: Correct non-compliant syntax or structure.
135
+ - Step 3: Re-run verification pipeline.
136
+
137
+ ### Scenario B: Missing Resource for Design System Governance
138
+ 1. **Diagnosis**: Target design token or configuration asset missing from workspace.
139
+ 2. **Recovery Protocol**:
140
+ - Step 1: Generate baseline resource file from standard template.
141
+ - Step 2: Update configuration references.
142
+ - Step 3: Resume runbook execution.
143
+
144
+ ## Verification & Validation Checklist
145
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
146
+ - [ ] All 7 mandatory sections present with explicit headers.
147
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
148
+ - [ ] Code exemplars provided with valid syntax fencing.
149
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
150
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.
@@ -0,0 +1,150 @@
1
+ ---
2
+ name: design-system-tokens
3
+ description: Production-grade Design System Tokens playbook for design
4
+ operations, UX systems, and growth strategy.
5
+ metadata:
6
+ author: agents-united
7
+ version: 2.0.0
8
+ icon: 🪙
9
+ disable-slash-command: true
10
+ ---
11
+
12
+ # Design System Tokens
13
+
14
+ ## Overview & Purpose
15
+ The Design System Tokens skill provides a deterministic framework for executing design system tokens processes in modern software products.
16
+
17
+ Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
18
+
19
+ ## Execution Triggers & Prerequisites
20
+ ### Execution Triggers
21
+ - Direct request to execute Design System Tokens tasks.
22
+ - Auditing existing product assets or workflows.
23
+ - Standardizing design-system-tokens procedures across team projects.
24
+ - Preparing design handoffs or growth campaign launches.
25
+
26
+ ### Prerequisites
27
+ - Project workspace configured with design system tokens or component libraries.
28
+ - Target UI design specification or growth experiment hypothesis.
29
+ - Testing and linting tools operational.
30
+ - Clean git working directory.
31
+
32
+ ## Input & Output Requirements
33
+ ### Inputs
34
+ | Parameter | Type | Required | Description |
35
+ |---|---|---|---|
36
+ | `target_scope` | String | Yes | Target UI component, page, or campaign scope |
37
+ | `config` | Object | Optional | Specific parameters and threshold configurations |
38
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
39
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
40
+
41
+ ### Outputs
42
+ | Artifact | Path / Format | Description |
43
+ |---|---|---|
44
+ | Specification Document | `docs/design-system-tokens/spec.md` | Full specification and guidelines document |
45
+ | Component / Asset Files | `src/design-system-tokens/*` | Implemented design tokens, components, or campaign assets |
46
+ | Audit Report | `reports/design-system-tokens/summary.json` | Health check and audit metric results |
47
+
48
+ ## Step-by-Step Execution Runbook
49
+
50
+ ### Phase 1: Pre-Execution Discovery & Workspace Analysis
51
+ 1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
52
+ ```bash
53
+ find src/ docs/ -maxdepth 3 -type f
54
+ ```
55
+ 2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
56
+ 3. Establish baseline quality metrics and target benchmarks.
57
+ 4. Verify working tree status to ensure clean git workspace.
58
+ ```bash
59
+ git status --short
60
+ ```
61
+ 5. Formulate initial execution plan.
62
+
63
+ ### Phase 2: Input Contract Validation & Strategy Selection
64
+ 1. Validate input parameters against technical feasibility and design system guidelines.
65
+ 2. Select implementation pattern matching component or campaign architecture.
66
+ 3. Establish verification rules and accessibility / conversion thresholds.
67
+ 4. Formulate atomic step-by-step execution sequence.
68
+ 5. Create temporary working directory if needed.
69
+
70
+ ### Phase 3: Core Step-by-Step Implementation Execution
71
+ 1. Author primary specification document at `docs/design-system-tokens/spec.md`.
72
+ 2. Generate code, token, or layout implementation files.
73
+ ```bash
74
+ npm run typecheck
75
+ ```
76
+ 3. Apply automated formatting and linting tools.
77
+ 4. Execute unit or visual regression tests.
78
+ ```bash
79
+ npm test
80
+ ```
81
+ 5. Refactor asset structure for optimal performance and maintainability.
82
+
83
+ ### Phase 4: Verification, Testing & Quality Gate Checking
84
+ 1. Run full project verification suite.
85
+ ```bash
86
+ npm run typecheck && npm test && npm run build
87
+ ```
88
+ 2. Verify zero lint errors, type warnings, or broken references.
89
+ 3. Execute CLI health doctor check.
90
+ ```bash
91
+ node dist/cli.js doctor
92
+ ```
93
+ 4. Assert all acceptance criteria are satisfied.
94
+
95
+ ### Phase 5: Post-Execution Cleanup & Artifact Generation
96
+ 1. Generate execution summary report at `reports/design-system-tokens/summary.md`.
97
+ 2. Clean up temporary build artifacts and scratch files.
98
+ 3. Commit generated files to git repository.
99
+ ```bash
100
+ git add docs/design-system-tokens/ reports/design-system-tokens/
101
+ git commit -m "feat(design-system-tokens): implement Design System Tokens playbook artifacts"
102
+ ```
103
+ 4. Publish documentation for team review.
104
+
105
+ ## Code & Configuration Exemplars
106
+
107
+ ### Exemplar 1: Design System Tokens Configuration Specification
108
+ ```yaml
109
+ version: "2.0.0"
110
+ metadata:
111
+ skill: "design-system-tokens"
112
+ author: "agents-united"
113
+ rules:
114
+ strictValidation: true
115
+ reporting:
116
+ format: "json"
117
+ output: "reports/design-system-tokens/summary.json"
118
+ ```
119
+
120
+ ### Exemplar 2: Design System Tokens Helper Module
121
+ ```typescript
122
+ export function runDesignSystemTokens(scope: string): boolean {
123
+ console.log('Running Design System Tokens on:', scope);
124
+ return true;
125
+ }
126
+ ```
127
+
128
+ ## Edge Cases & Error Recovery Procedures
129
+
130
+ ### Scenario A: Validation Failure in Design System Tokens
131
+ 1. **Diagnosis**: Specification or code asset fails validation rules in design-system-tokens.
132
+ 2. **Recovery Protocol**:
133
+ - Step 1: Inspect error log at reports directory.
134
+ - Step 2: Correct non-compliant syntax or structure.
135
+ - Step 3: Re-run verification pipeline.
136
+
137
+ ### Scenario B: Missing Resource for Design System Tokens
138
+ 1. **Diagnosis**: Target design token or configuration asset missing from workspace.
139
+ 2. **Recovery Protocol**:
140
+ - Step 1: Generate baseline resource file from standard template.
141
+ - Step 2: Update configuration references.
142
+ - Step 3: Resume runbook execution.
143
+
144
+ ## Verification & Validation Checklist
145
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
146
+ - [ ] All 7 mandatory sections present with explicit headers.
147
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
148
+ - [ ] Code exemplars provided with valid syntax fencing.
149
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
150
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.
@@ -0,0 +1,150 @@
1
+ ---
2
+ name: design-tokens-management
3
+ description: Production-grade Design Tokens Management playbook for design
4
+ operations, UX systems, and growth strategy.
5
+ metadata:
6
+ author: agents-united
7
+ version: 2.0.0
8
+ icon: 🎨
9
+ disable-slash-command: true
10
+ ---
11
+
12
+ # Design Tokens Management
13
+
14
+ ## Overview & Purpose
15
+ The Design Tokens Management skill provides a deterministic framework for executing design tokens management processes in modern software products.
16
+
17
+ Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
18
+
19
+ ## Execution Triggers & Prerequisites
20
+ ### Execution Triggers
21
+ - Direct request to execute Design Tokens Management tasks.
22
+ - Auditing existing product assets or workflows.
23
+ - Standardizing design-tokens-management procedures across team projects.
24
+ - Preparing design handoffs or growth campaign launches.
25
+
26
+ ### Prerequisites
27
+ - Project workspace configured with design system tokens or component libraries.
28
+ - Target UI design specification or growth experiment hypothesis.
29
+ - Testing and linting tools operational.
30
+ - Clean git working directory.
31
+
32
+ ## Input & Output Requirements
33
+ ### Inputs
34
+ | Parameter | Type | Required | Description |
35
+ |---|---|---|---|
36
+ | `target_scope` | String | Yes | Target UI component, page, or campaign scope |
37
+ | `config` | Object | Optional | Specific parameters and threshold configurations |
38
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
39
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
40
+
41
+ ### Outputs
42
+ | Artifact | Path / Format | Description |
43
+ |---|---|---|
44
+ | Specification Document | `docs/design-tokens-management/spec.md` | Full specification and guidelines document |
45
+ | Component / Asset Files | `src/design-tokens-management/*` | Implemented design tokens, components, or campaign assets |
46
+ | Audit Report | `reports/design-tokens-management/summary.json` | Health check and audit metric results |
47
+
48
+ ## Step-by-Step Execution Runbook
49
+
50
+ ### Phase 1: Pre-Execution Discovery & Workspace Analysis
51
+ 1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
52
+ ```bash
53
+ find src/ docs/ -maxdepth 3 -type f
54
+ ```
55
+ 2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
56
+ 3. Establish baseline quality metrics and target benchmarks.
57
+ 4. Verify working tree status to ensure clean git workspace.
58
+ ```bash
59
+ git status --short
60
+ ```
61
+ 5. Formulate initial execution plan.
62
+
63
+ ### Phase 2: Input Contract Validation & Strategy Selection
64
+ 1. Validate input parameters against technical feasibility and design system guidelines.
65
+ 2. Select implementation pattern matching component or campaign architecture.
66
+ 3. Establish verification rules and accessibility / conversion thresholds.
67
+ 4. Formulate atomic step-by-step execution sequence.
68
+ 5. Create temporary working directory if needed.
69
+
70
+ ### Phase 3: Core Step-by-Step Implementation Execution
71
+ 1. Author primary specification document at `docs/design-tokens-management/spec.md`.
72
+ 2. Generate code, token, or layout implementation files.
73
+ ```bash
74
+ npm run typecheck
75
+ ```
76
+ 3. Apply automated formatting and linting tools.
77
+ 4. Execute unit or visual regression tests.
78
+ ```bash
79
+ npm test
80
+ ```
81
+ 5. Refactor asset structure for optimal performance and maintainability.
82
+
83
+ ### Phase 4: Verification, Testing & Quality Gate Checking
84
+ 1. Run full project verification suite.
85
+ ```bash
86
+ npm run typecheck && npm test && npm run build
87
+ ```
88
+ 2. Verify zero lint errors, type warnings, or broken references.
89
+ 3. Execute CLI health doctor check.
90
+ ```bash
91
+ node dist/cli.js doctor
92
+ ```
93
+ 4. Assert all acceptance criteria are satisfied.
94
+
95
+ ### Phase 5: Post-Execution Cleanup & Artifact Generation
96
+ 1. Generate execution summary report at `reports/design-tokens-management/summary.md`.
97
+ 2. Clean up temporary build artifacts and scratch files.
98
+ 3. Commit generated files to git repository.
99
+ ```bash
100
+ git add docs/design-tokens-management/ reports/design-tokens-management/
101
+ git commit -m "feat(design-tokens-management): implement Design Tokens Management playbook artifacts"
102
+ ```
103
+ 4. Publish documentation for team review.
104
+
105
+ ## Code & Configuration Exemplars
106
+
107
+ ### Exemplar 1: Design Tokens Management Configuration Specification
108
+ ```yaml
109
+ version: "2.0.0"
110
+ metadata:
111
+ skill: "design-tokens-management"
112
+ author: "agents-united"
113
+ rules:
114
+ strictValidation: true
115
+ reporting:
116
+ format: "json"
117
+ output: "reports/design-tokens-management/summary.json"
118
+ ```
119
+
120
+ ### Exemplar 2: Design Tokens Management Helper Module
121
+ ```typescript
122
+ export function runDesignTokensManagement(scope: string): boolean {
123
+ console.log('Running Design Tokens Management on:', scope);
124
+ return true;
125
+ }
126
+ ```
127
+
128
+ ## Edge Cases & Error Recovery Procedures
129
+
130
+ ### Scenario A: Validation Failure in Design Tokens Management
131
+ 1. **Diagnosis**: Specification or code asset fails validation rules in design-tokens-management.
132
+ 2. **Recovery Protocol**:
133
+ - Step 1: Inspect error log at reports directory.
134
+ - Step 2: Correct non-compliant syntax or structure.
135
+ - Step 3: Re-run verification pipeline.
136
+
137
+ ### Scenario B: Missing Resource for Design Tokens Management
138
+ 1. **Diagnosis**: Target design token or configuration asset missing from workspace.
139
+ 2. **Recovery Protocol**:
140
+ - Step 1: Generate baseline resource file from standard template.
141
+ - Step 2: Update configuration references.
142
+ - Step 3: Resume runbook execution.
143
+
144
+ ## Verification & Validation Checklist
145
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
146
+ - [ ] All 7 mandatory sections present with explicit headers.
147
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
148
+ - [ ] Code exemplars provided with valid syntax fencing.
149
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
150
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.
@@ -0,0 +1,150 @@
1
+ ---
2
+ name: design-version-control
3
+ description: Production-grade Design Version Control playbook for design
4
+ operations, UX systems, and growth strategy.
5
+ metadata:
6
+ author: agents-united
7
+ version: 2.0.0
8
+ icon: 🔀
9
+ disable-slash-command: true
10
+ ---
11
+
12
+ # Design Version Control
13
+
14
+ ## Overview & Purpose
15
+ The Design Version Control skill provides a deterministic framework for executing design version control processes in modern software products.
16
+
17
+ Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
18
+
19
+ ## Execution Triggers & Prerequisites
20
+ ### Execution Triggers
21
+ - Direct request to execute Design Version Control tasks.
22
+ - Auditing existing product assets or workflows.
23
+ - Standardizing design-version-control procedures across team projects.
24
+ - Preparing design handoffs or growth campaign launches.
25
+
26
+ ### Prerequisites
27
+ - Project workspace configured with design system tokens or component libraries.
28
+ - Target UI design specification or growth experiment hypothesis.
29
+ - Testing and linting tools operational.
30
+ - Clean git working directory.
31
+
32
+ ## Input & Output Requirements
33
+ ### Inputs
34
+ | Parameter | Type | Required | Description |
35
+ |---|---|---|---|
36
+ | `target_scope` | String | Yes | Target UI component, page, or campaign scope |
37
+ | `config` | Object | Optional | Specific parameters and threshold configurations |
38
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
39
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
40
+
41
+ ### Outputs
42
+ | Artifact | Path / Format | Description |
43
+ |---|---|---|
44
+ | Specification Document | `docs/design-version-control/spec.md` | Full specification and guidelines document |
45
+ | Component / Asset Files | `src/design-version-control/*` | Implemented design tokens, components, or campaign assets |
46
+ | Audit Report | `reports/design-version-control/summary.json` | Health check and audit metric results |
47
+
48
+ ## Step-by-Step Execution Runbook
49
+
50
+ ### Phase 1: Pre-Execution Discovery & Workspace Analysis
51
+ 1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
52
+ ```bash
53
+ find src/ docs/ -maxdepth 3 -type f
54
+ ```
55
+ 2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
56
+ 3. Establish baseline quality metrics and target benchmarks.
57
+ 4. Verify working tree status to ensure clean git workspace.
58
+ ```bash
59
+ git status --short
60
+ ```
61
+ 5. Formulate initial execution plan.
62
+
63
+ ### Phase 2: Input Contract Validation & Strategy Selection
64
+ 1. Validate input parameters against technical feasibility and design system guidelines.
65
+ 2. Select implementation pattern matching component or campaign architecture.
66
+ 3. Establish verification rules and accessibility / conversion thresholds.
67
+ 4. Formulate atomic step-by-step execution sequence.
68
+ 5. Create temporary working directory if needed.
69
+
70
+ ### Phase 3: Core Step-by-Step Implementation Execution
71
+ 1. Author primary specification document at `docs/design-version-control/spec.md`.
72
+ 2. Generate code, token, or layout implementation files.
73
+ ```bash
74
+ npm run typecheck
75
+ ```
76
+ 3. Apply automated formatting and linting tools.
77
+ 4. Execute unit or visual regression tests.
78
+ ```bash
79
+ npm test
80
+ ```
81
+ 5. Refactor asset structure for optimal performance and maintainability.
82
+
83
+ ### Phase 4: Verification, Testing & Quality Gate Checking
84
+ 1. Run full project verification suite.
85
+ ```bash
86
+ npm run typecheck && npm test && npm run build
87
+ ```
88
+ 2. Verify zero lint errors, type warnings, or broken references.
89
+ 3. Execute CLI health doctor check.
90
+ ```bash
91
+ node dist/cli.js doctor
92
+ ```
93
+ 4. Assert all acceptance criteria are satisfied.
94
+
95
+ ### Phase 5: Post-Execution Cleanup & Artifact Generation
96
+ 1. Generate execution summary report at `reports/design-version-control/summary.md`.
97
+ 2. Clean up temporary build artifacts and scratch files.
98
+ 3. Commit generated files to git repository.
99
+ ```bash
100
+ git add docs/design-version-control/ reports/design-version-control/
101
+ git commit -m "feat(design-version-control): implement Design Version Control playbook artifacts"
102
+ ```
103
+ 4. Publish documentation for team review.
104
+
105
+ ## Code & Configuration Exemplars
106
+
107
+ ### Exemplar 1: Design Version Control Configuration Specification
108
+ ```yaml
109
+ version: "2.0.0"
110
+ metadata:
111
+ skill: "design-version-control"
112
+ author: "agents-united"
113
+ rules:
114
+ strictValidation: true
115
+ reporting:
116
+ format: "json"
117
+ output: "reports/design-version-control/summary.json"
118
+ ```
119
+
120
+ ### Exemplar 2: Design Version Control Helper Module
121
+ ```typescript
122
+ export function runDesignVersionControl(scope: string): boolean {
123
+ console.log('Running Design Version Control on:', scope);
124
+ return true;
125
+ }
126
+ ```
127
+
128
+ ## Edge Cases & Error Recovery Procedures
129
+
130
+ ### Scenario A: Validation Failure in Design Version Control
131
+ 1. **Diagnosis**: Specification or code asset fails validation rules in design-version-control.
132
+ 2. **Recovery Protocol**:
133
+ - Step 1: Inspect error log at reports directory.
134
+ - Step 2: Correct non-compliant syntax or structure.
135
+ - Step 3: Re-run verification pipeline.
136
+
137
+ ### Scenario B: Missing Resource for Design Version Control
138
+ 1. **Diagnosis**: Target design token or configuration asset missing from workspace.
139
+ 2. **Recovery Protocol**:
140
+ - Step 1: Generate baseline resource file from standard template.
141
+ - Step 2: Update configuration references.
142
+ - Step 3: Resume runbook execution.
143
+
144
+ ## Verification & Validation Checklist
145
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
146
+ - [ ] All 7 mandatory sections present with explicit headers.
147
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
148
+ - [ ] Code exemplars provided with valid syntax fencing.
149
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
150
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.
@@ -0,0 +1,45 @@
1
+ ---
2
+ name: diagnosing-bugs
3
+ description: Evidence-based bug diagnosis and root-cause analysis workflow to
4
+ isolate defect origins without blind guesswork.
5
+ metadata:
6
+ author: Matt Pocock (mattpocock/skills)
7
+ version: 1.0.0
8
+ source: https://github.com/mattpocock/skills
9
+ icon: 🔍
10
+ ---
11
+
12
+ # Evidence-Driven Bug Diagnosis
13
+
14
+ ## Overview & Purpose
15
+ `diagnosing-bugs` provides a step-by-step diagnostic workflow for isolating runtime failures, unexpected behaviors, and regressions by gathering empirical evidence before attempting fixes.
16
+
17
+ ## Input & Output Requirements
18
+ ### Inputs
19
+ | Parameter | Type | Required | Description |
20
+ |---|---|---|---|
21
+ | `error_log` | String / Path | Yes | Error log, stack trace, or bug report snippet |
22
+
23
+ ### Outputs
24
+ | Artifact | Path / Format | Description |
25
+ |---|---|---|
26
+ | Diagnosis Report | Inline / Log | Isolated root cause evidence and targeted fix plan |
27
+
28
+ ## Step-by-Step Execution Runbook
29
+
30
+ ### Phase 1 — Evidence Gathering
31
+ 1. Extract exact error messages, stack traces, line numbers, and runtime environments.
32
+ 2. Read the full un-truncated source code around the reported crash site.
33
+
34
+ ### Phase 2 — Reproduction & Hypothesis Testing
35
+ 1. Create a minimal automated reproduction test case.
36
+ 2. Formulate 2–3 candidate hypotheses and test them systematically.
37
+ 3. Confirm exact conditions required to trigger the bug.
38
+
39
+ ### Phase 3 — Root Cause Summary
40
+ 1. Document the exact mechanism causing the failure.
41
+ 2. Hand off verified root cause to implementation/fix workflow.
42
+
43
+ ## Verification & Validation Checklist
44
+ - [ ] Frontmatter contains author attribution to Matt Pocock.
45
+ - [ ] Diagnosis is backed by empirical stack trace or log evidence.