feat(arch): composite skill architecture + SEO reference implementation#112
Merged
Conversation
New architecture: composite skills collapse fragmented skills into domain-aware pipelines with shared memory, evaluation rubrics, and cross-session learning. - COMPOSITE-SPEC.md: Template pattern for all composites (router + sub-skills + evaluation + memory) - /seo composite: Router with 4 actions (audit, create, research, monitor) - seo/sub-skills/audit.md: Full 4-phase audit runbook (technical, content, competitor, scoring) - seo/evaluation/rubric.yml: Per-action scoring dimensions with weights - seo/memory/schema.yml: Domain-specific persistence (profile, keywords, audit history, learnings) This replaces 9 fragmented SEO skills with 1 composite that has shared memory and evaluation. Pattern applies to all 14 planned composites.
Two more composites following the COMPOSITE-SPEC.md pattern: /pos-security — 7-domain OWASP audit, dependency scan, hardening with vulnerability memory (vuln-history, dependency-audit, learnings). Replaces 9 fragmented security skills. /pos-review — 2-pass PR review, code review, architecture review with codebase pattern memory (review-history, recurring patterns, suppressions). Replaces 7 fragmented review skills. Both have: router SKILL.md, evaluation rubric.yml, memory schema.yml. Pattern: 16 fragmented skills -> 2 composites with shared memory.
4 more composite skills following COMPOSITE-SPEC.md: /pos-content — strategy, write, audit, refresh with brand voice memory. Replaces 10 content skills. /pos-ads — audit, create, optimize, report with campaign memory. Replaces 20 ads skills. /pos-plan — ceo, eng, design, brainstorm with decision memory. Replaces 8 planning skills. /pos-build — brainstorm, plan, implement, test with project memory. Replaces 6 build skills. Running total: 7 composites absorb 80 fragmented skills. Each has router + evaluation rubric + memory schema pattern.
Final 7 composites completing the full architecture: /pos-debug — diagnose, fix, verify with bug pattern memory (4 skills) /pos-research — quick, deep, exhaustive with citation memory (5 skills) /pos-ship — pr, deploy, canary, rollback with release memory (4 skills) /pos-qa — test, audit, browse with test result memory (5 skills) /pos-frontend — audit, upgrade, design with design token memory (10 skills) /pos-github — pr, issue, release, workflow with project memory (8 skills) /pos-n8n — create, import, debug, monitor with workflow memory (33 skills) Complete set: 14 composites absorb 138 fragmented skills. Each has: router SKILL.md + evaluation/rubric.yml + memory pattern.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
New composite skill architecture that collapses fragmented skills into domain-aware pipelines with shared memory, evaluation rubrics, and cross-session learning.
What's new
templates/composite-skill/COMPOSITE-SPEC.md— Pattern template for all compositesskills/seo/— First reference composite with:sub-skills/audit.md— Full 4-phase audit runbookevaluation/rubric.yml— Per-action scoring dimensions with weightsmemory/schema.yml— Domain persistence (profile, keywords, audit history, learnings)Architecture
Impact
Test plan
bun testpasses