our-claude-skills/docs/SKILLS_COMPARISON.md

Skills Comparison: Current vs Refactored

Date: 2025-12-21

Summary

Metric	Current	Refactored	Change
Total Skills	8	18	+125%
Monolithic Skills	2	0	-100%
Single-purpose Skills	6	18	+200%
SEO Skills	1 (6,049 LOC)	9 (decomposed)	Modular
GTM Skills	1	2	Separated

---

Current Active Skills (Claude Code)

These skills are currently registered and accessible via /skill-name:

#	Skill Name	Purpose	Issues
1	doc-generator	PDF/PPT generation	OK
2	notion-organizer	Notion workspace management	OK
3	ourdigital-gtm-manager	GTM management + dataLayer injection	Monolithic
4	ourdigital-seo-audit	Comprehensive SEO audit	Monolithic (6,049 LOC)
5	seo-manager	SEO management agent	OK
6	skill-creator	Claude skill creation wizard	OK
7	test	Python test runner	Generic utility
8	lint	Python linter	Generic utility

Problems with Current Skills

1. ourdigital-seo-audit: 6,049 lines across 11 scripts - too heavy, does too many things
2. ourdigital-gtm-manager: Combines audit + tag generation - should be split
3. No clear separation: Hard to know which skill to use for specific tasks

---

Refactored Skills (New Structure)

01-09: General Automation

#	Skill	Purpose	LOC	Status
01	notion-organizer	Notion workspace management	~600	✅ Ready
02	notion-data-migration	Database schema migration	~400	✅ Ready

10-19: SEO Skills (Decomposed from seo-audit-agent)

#	Skill	Purpose	Source Scripts	Status
10	seo-technical-audit	robots.txt, sitemap validation	robots_checker, sitemap_*	✅ Ready
11	seo-on-page-audit	Meta tags, headings, links	page_analyzer	✅ Ready
12	seo-local-audit	NAP, GBP, citations	Guidance-only	✅ Ready
13	seo-schema-validator	JSON-LD validation	schema_validator	✅ Ready
14	seo-schema-generator	Schema markup generation	schema_generator	✅ Ready
15	seo-core-web-vitals	PageSpeed metrics	pagespeed_client	✅ Ready
16	seo-search-console	GSC data retrieval	gsc_client	✅ Ready
17	seo-gateway-architect	Keyword strategy planning	keyword_analyzer	✅ Ready
18	seo-gateway-builder	Gateway page generation	generate_pages	✅ Ready

20-29: GTM/GA Skills

#	Skill	Purpose	Status
20	gtm-audit	Lightweight GTM audit only	✅ Ready
21	gtm-manager	Full GTM management + dataLayer injection	✅ Ready

30-39: OurDigital Skills

#	Skill	Purpose	Status
30	ourdigital-designer	Blog featured image prompts	✅ Ready
31	ourdigital-research	Research → Blog export	✅ Ready
32	ourdigital-presentation	Notion → PowerPoint workflow	✅ Ready

40-49: Jamie Clinic Skills

#	Skill	Purpose	Status
40	jamie-brand-editor	Content generation	✅ Ready
41	jamie-brand-audit	Content review/evaluation	✅ Ready

---

Key Improvements

1. SEO Decomposition

Before (Monolithic):

seo-audit-agent/
├── scripts/
│   ├── base_client.py        (207 LOC)
│   ├── full_audit.py         (497 LOC)
│   ├── gsc_client.py         (409 LOC)
│   ├── notion_reporter.py    (951 LOC)
│   ├── page_analyzer.py      (569 LOC)
│   ├── pagespeed_client.py   (452 LOC)
│   ├── robots_checker.py     (540 LOC)
│   ├── schema_generator.py   (490 LOC)
│   ├── schema_validator.py   (498 LOC)
│   ├── sitemap_crawler.py    (969 LOC)
│   └── sitemap_validator.py  (467 LOC)
└── Total: 6,049 LOC in ONE skill

After (Modular):

10-seo-technical-audit/    → robots + sitemap
11-seo-on-page-audit/      → page analysis
12-seo-local-audit/        → local SEO (guidance)
13-seo-schema-validator/   → schema validation
14-seo-schema-generator/   → schema generation
15-seo-core-web-vitals/    → PageSpeed
16-seo-search-console/     → GSC data
17-seo-gateway-architect/  → keyword strategy
18-seo-gateway-builder/    → page generation

→ 9 focused skills, each ~400-600 LOC max

2. GTM Separation

Before:

ourdigital-gtm-manager/    → Everything in one

After:

20-gtm-audit/              → Audit only (lightweight)
21-gtm-manager/            → Full management + injection

3. Jamie Clinic Clarity

Before:

jamie-brand-editor/        → Unclear if create or review
jamie-brand-guardian/      → Confusing name

After:

40-jamie-brand-editor/     → Content GENERATION
41-jamie-brand-audit/      → Content REVIEW

4. Dual-Platform Support

Each skill now has:

skill-name/
├── code/                  → Claude Code (CLI)
│   ├── CLAUDE.md
│   └── scripts/
└── desktop/               → Claude Desktop
    ├── SKILL.md
    └── references/

---

Migration Path

Skills to Keep (No Change)

Current	Status
doc-generator	Keep as-is
skill-creator	Keep as-is
test	Keep as-is
lint	Keep as-is

Skills to Replace

Current	Replace With	Notes
ourdigital-seo-audit	10-16 (7 skills)	Full decomposition
ourdigital-gtm-manager	20-gtm-audit + 21-gtm-manager	Separated roles
notion-organizer	01-notion-organizer	Refactored structure
seo-manager	17-seo-gateway-architect	More focused

New Skills to Add

New Skill	Purpose
02-notion-data-migration	Schema migration
18-seo-gateway-builder	Content generation
30-ourdigital-designer	Image prompts
31-ourdigital-research	Research export
32-ourdigital-presentation	Slides generation
40-jamie-brand-editor	Content creation
41-jamie-brand-audit	Content review

---

Recommended Actions

1. Backup current skills: Copy current ~/.claude/commands/ before changes

2. Install refactored skills: Link or copy CLAUDE.md files to project

3. Update skill references: Update any automation scripts that reference old skill names

4. Test each skill: Run python script.py --help for each script

5. Archive old skills: Move deprecated skills to _archive/

---

Directory Structure After Migration

~/.claude/commands/
├── lint.md                    (keep)
└── test.md                    (keep)

project/.claude/commands/
├── 01-notion-organizer.md
├── 10-seo-technical-audit.md
├── 11-seo-on-page-audit.md
├── ...
├── 20-gtm-audit.md
├── 21-gtm-manager.md
├── 30-ourdigital-designer.md
├── ...
├── 40-jamie-brand-editor.md
└── 41-jamie-brand-audit.md

---

Conclusion

The refactoring achieves:

1. "One thing done well": Each skill has a single clear purpose
2. Reduced complexity: Max ~600 LOC per skill vs 6,049 LOC monolith
3. Clear naming: audit vs manager, editor vs audit
4. Better discoverability: Numbered categories (10-19 = SEO, 20-29 = GTM, etc.)
5. Platform separation: code/ for CLI, desktop/ for Desktop app