refactor: Reorganize skill numbering and update documentation
Skill Numbering Changes: - 01-03: OurDigital core (was 30-32) - 31-32: Notion tools (was 01-02) - 99_archive: Renamed from _archive for sorting New Files: - AGENTS.md: Claude Code agent routing guide - requirements.txt for 00-claude-code-setting, 32-notion-writer, 43-jamie-youtube-manager Documentation Updates: - CLAUDE.md: Updated skill inventory (23 skills) - AUDIT_REPORT.md: Current completion status (91%) - Archived REFACTORING_PLAN.md (most tasks complete) Removed: - ga-agent-skills/ (moved to separate repo ~/Project/dintel-ga4-agent) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,119 +1,158 @@
|
||||
# Skills Audit Report
|
||||
|
||||
Generated: 2024-12-21
|
||||
**Generated**: 2025-01-23
|
||||
**Previous Audit**: 2024-12-21
|
||||
|
||||
## Summary
|
||||
|
||||
| Status | Count |
|
||||
|--------|-------|
|
||||
| Complete (code + desktop) | 8 |
|
||||
| Partial (missing CLAUDE.md or scripts) | 9 |
|
||||
| Empty (placeholder only) | 1 |
|
||||
| Status | Count | Change |
|
||||
|--------|-------|--------|
|
||||
| Complete (code + desktop) | 19 | +11 |
|
||||
| Partial (missing desktop or scripts) | 4 | -5 |
|
||||
| Total Skills | 23 | +5 new |
|
||||
|
||||
### Key Improvements Since Last Audit
|
||||
|
||||
1. **All 23 skills now have `code/CLAUDE.md`** (was 8)
|
||||
2. **Reorganized numbering scheme** - OurDigital moved to 01-03, Notion to 31-32
|
||||
3. **5 new skills added**: 00-claude-code-setting, 22-gtm-guardian, 44-jamie-youtube-subtitle-checker
|
||||
4. **notion-data-migration renamed to notion-writer** (32)
|
||||
|
||||
---
|
||||
|
||||
## Detailed Audit by Skill
|
||||
|
||||
### 01-09: General Automation
|
||||
### Claude Code Settings (00)
|
||||
|
||||
| # | Skill | code/CLAUDE.md | code/scripts | code/requirements.txt | desktop/SKILL.md | Status |
|
||||
|---|-------|----------------|--------------|----------------------|------------------|--------|
|
||||
| 01 | notion-organizer | **MISSING** | async_organizer.py, schema_migrator.py | YES | YES | Partial |
|
||||
| 02 | notion-data-migration | **MISSING** | **EMPTY** | **MISSING** | **MISSING** | Empty |
|
||||
| # | Skill | code/CLAUDE.md | desktop/SKILL.md | Scripts | Status |
|
||||
|---|-------|----------------|------------------|---------|--------|
|
||||
| 00 | claude-code-setting | YES | **MISSING** | 4 | Partial |
|
||||
|
||||
### 10-19: SEO Tools
|
||||
### OurDigital Core (01-09)
|
||||
|
||||
| # | Skill | code/CLAUDE.md | code/scripts | code/requirements.txt | desktop/SKILL.md | Status |
|
||||
|---|-------|----------------|--------------|----------------------|------------------|--------|
|
||||
| 10 | seo-technical-audit | YES | robots_checker, sitemap_validator, sitemap_crawler, page_analyzer, base_client | YES | YES | **Complete** |
|
||||
| 11 | seo-on-page-audit | YES | page_analyzer, base_client | YES | YES | **Complete** |
|
||||
| 12 | seo-local-audit | YES | **EMPTY** (new skill) | **MISSING** | YES | Partial |
|
||||
| 13 | seo-schema-validator | YES | schema_validator, base_client | YES | YES | **Complete** |
|
||||
| 14 | seo-schema-generator | YES | schema_generator, base_client + templates/ | YES | YES | **Complete** |
|
||||
| 15 | seo-core-web-vitals | YES | pagespeed_client, base_client | YES | YES | **Complete** |
|
||||
| 16 | seo-search-console | YES | gsc_client, base_client | YES | YES | **Complete** |
|
||||
| 17 | seo-gateway-architect | **MISSING** | keyword_analyzer.py | YES | YES | Partial |
|
||||
| 18 | seo-gateway-builder | **MISSING** | generate_pages.py | **MISSING** | YES | Partial |
|
||||
| # | Skill | code/CLAUDE.md | desktop/SKILL.md | Scripts | Status |
|
||||
|---|-------|----------------|------------------|---------|--------|
|
||||
| 01 | ourdigital-research | YES | YES | 1 | **Complete** |
|
||||
| 02 | ourdigital-designer | YES | YES | 2 | **Complete** |
|
||||
| 03 | ourdigital-presentation | YES | YES | 4 | **Complete** |
|
||||
|
||||
### 20-29: GTM/GA Tools
|
||||
### SEO Tools (10-19)
|
||||
|
||||
| # | Skill | code/CLAUDE.md | code/scripts | code/requirements.txt | desktop/SKILL.md | Status |
|
||||
|---|-------|----------------|--------------|----------------------|------------------|--------|
|
||||
| 20 | gtm-audit | YES | gtm_audit.py | YES | YES | **Complete** |
|
||||
| 21 | gtm-manager | YES | gtm_manager.py + docs/ | YES | YES | **Complete** |
|
||||
| # | Skill | code/CLAUDE.md | desktop/SKILL.md | Scripts | Status |
|
||||
|---|-------|----------------|------------------|---------|--------|
|
||||
| 10 | seo-technical-audit | YES | YES | 5 | **Complete** |
|
||||
| 11 | seo-on-page-audit | YES | YES | 2 | **Complete** |
|
||||
| 12 | seo-local-audit | YES | YES | 0 (guidance) | **Complete** |
|
||||
| 13 | seo-schema-validator | YES | YES | 2 | **Complete** |
|
||||
| 14 | seo-schema-generator | YES | YES | 2 | **Complete** |
|
||||
| 15 | seo-core-web-vitals | YES | YES | 2 | **Complete** |
|
||||
| 16 | seo-search-console | YES | YES | 2 | **Complete** |
|
||||
| 17 | seo-gateway-architect | YES | YES | 1 | **Complete** |
|
||||
| 18 | seo-gateway-builder | YES | YES | 1 | **Complete** |
|
||||
|
||||
### 30-39: OurDigital Channel
|
||||
### GTM/GA Tools (20-29)
|
||||
|
||||
| # | Skill | code/CLAUDE.md | code/scripts | code/requirements.txt | desktop/SKILL.md | Status |
|
||||
|---|-------|----------------|--------------|----------------------|------------------|--------|
|
||||
| 30 | ourdigital-designer | **MISSING** | generate_prompt.py, mood_calibrator.py | **MISSING** | YES | Partial |
|
||||
| 31 | ourdigital-research | **MISSING** | export_to_ulysses.py | **MISSING** | YES | Partial |
|
||||
| 32 | ourdigital-presentation | **MISSING** | apply_brand.py, extract_notion.py, run_workflow.py, synthesize_content.py | **MISSING** | YES | Partial |
|
||||
| # | Skill | code/CLAUDE.md | desktop/SKILL.md | Scripts | Status |
|
||||
|---|-------|----------------|------------------|---------|--------|
|
||||
| 20 | gtm-audit | YES | YES | 1 | **Complete** |
|
||||
| 21 | gtm-manager | YES | **MISSING** | 1 | Partial |
|
||||
| 22 | gtm-guardian | YES | YES | 0 (guidance) | **Complete** |
|
||||
|
||||
### 40-49: Jamie Clinic
|
||||
### Notion Tools (31-39)
|
||||
|
||||
| # | Skill | code/CLAUDE.md | code/scripts | code/requirements.txt | desktop/SKILL.md | Status |
|
||||
|---|-------|----------------|--------------|----------------------|------------------|--------|
|
||||
| 40 | jamie-brand-editor | **MISSING** | compliance_checker.py | **MISSING** | YES | Partial |
|
||||
| 41 | jamie-brand-audit | **MISSING** | **EMPTY** | **MISSING** | YES | Partial |
|
||||
| # | Skill | code/CLAUDE.md | desktop/SKILL.md | Scripts | Status |
|
||||
|---|-------|----------------|------------------|---------|--------|
|
||||
| 31 | notion-organizer | YES | YES | 2 | **Complete** |
|
||||
| 32 | notion-writer | YES | YES | 1 | **Complete** |
|
||||
|
||||
### Jamie Clinic (40-49)
|
||||
|
||||
| # | Skill | code/CLAUDE.md | desktop/SKILL.md | Scripts | Status |
|
||||
|---|-------|----------------|------------------|---------|--------|
|
||||
| 40 | jamie-brand-editor | YES | YES | 1 | **Complete** |
|
||||
| 41 | jamie-brand-audit | YES | YES | 0 (guidance) | **Complete** |
|
||||
| 42 | jamie-instagram-manager | YES | YES | 0 (guidance) | **Complete** |
|
||||
| 43 | jamie-youtube-manager | YES | YES | 4 | **Complete** |
|
||||
| 44 | jamie-youtube-subtitle-checker | YES | YES | 0 (guidance) | **Complete** |
|
||||
|
||||
---
|
||||
|
||||
## Issues to Fix
|
||||
|
||||
### Priority 1: Missing CLAUDE.md (Claude Code directive)
|
||||
### Priority 1: Missing desktop/SKILL.md
|
||||
|
||||
| Skill | Has Scripts | Action |
|
||||
|-------|-------------|--------|
|
||||
| 01-notion-organizer | YES | Create CLAUDE.md |
|
||||
| 17-seo-gateway-architect | YES | Create CLAUDE.md |
|
||||
| 18-seo-gateway-builder | YES | Create CLAUDE.md |
|
||||
| 30-ourdigital-designer | YES | Create CLAUDE.md |
|
||||
| 31-ourdigital-research | YES | Create CLAUDE.md |
|
||||
| 32-ourdigital-presentation | YES | Create CLAUDE.md |
|
||||
| 40-jamie-brand-editor | YES | Create CLAUDE.md |
|
||||
| 41-jamie-brand-audit | NO | Create CLAUDE.md (guidance only) |
|
||||
| 00-claude-code-setting | YES (4) | Create desktop/SKILL.md |
|
||||
| 21-gtm-manager | YES (1) | Create desktop/SKILL.md |
|
||||
|
||||
### Priority 2: Missing requirements.txt
|
||||
### Priority 2: Guidance-Only Skills (No Scripts - Intentional)
|
||||
|
||||
| Skill | Scripts Present | Action |
|
||||
|-------|-----------------|--------|
|
||||
| 12-seo-local-audit | NO | Skip (no scripts) |
|
||||
| 18-seo-gateway-builder | YES | Create requirements.txt |
|
||||
| 30-ourdigital-designer | YES | Create requirements.txt |
|
||||
| 31-ourdigital-research | YES | Create requirements.txt |
|
||||
| 32-ourdigital-presentation | YES | Create requirements.txt |
|
||||
| 40-jamie-brand-editor | YES | Create requirements.txt |
|
||||
These skills are designed to work through MCP tools or direct guidance:
|
||||
|
||||
### Priority 3: Empty/Placeholder Skills
|
||||
|
||||
| Skill | Action |
|
||||
| Skill | Reason |
|
||||
|-------|--------|
|
||||
| 02-notion-data-migration | Decide: implement or remove |
|
||||
| 12-seo-local-audit | Implement scripts or make guidance-only |
|
||||
| 41-jamie-brand-audit | Already guidance-only (has references, no scripts needed) |
|
||||
| 12-seo-local-audit | Uses MCP tools for NAP/GBP checks |
|
||||
| 22-gtm-guardian | Uses Chrome DevTools MCP + DTM Agent |
|
||||
| 41-jamie-brand-audit | Review/evaluation guidance only |
|
||||
| 42-jamie-instagram-manager | Strategy/planning guidance |
|
||||
| 44-jamie-youtube-subtitle-checker | QA workflow guidance |
|
||||
|
||||
---
|
||||
|
||||
## Complete Skills (Ready to Use)
|
||||
## Completion Metrics
|
||||
|
||||
These skills have all required components:
|
||||
### By Domain
|
||||
|
||||
1. **10-seo-technical-audit** - Robots.txt, sitemap validation
|
||||
2. **11-seo-on-page-audit** - Page meta tags, headings
|
||||
3. **13-seo-schema-validator** - Structured data validation
|
||||
4. **14-seo-schema-generator** - Schema markup generation
|
||||
5. **15-seo-core-web-vitals** - PageSpeed Insights
|
||||
6. **16-seo-search-console** - GSC data retrieval
|
||||
7. **20-gtm-audit** - GTM container audit
|
||||
8. **21-gtm-manager** - GTM management + injection
|
||||
| Domain | Complete | Partial | Total |
|
||||
|--------|----------|---------|-------|
|
||||
| Claude Code Settings | 0 | 1 | 1 |
|
||||
| OurDigital Core | 3 | 0 | 3 |
|
||||
| SEO Tools | 9 | 0 | 9 |
|
||||
| GTM/GA Tools | 2 | 1 | 3 |
|
||||
| Notion Tools | 2 | 0 | 2 |
|
||||
| Jamie Clinic | 5 | 0 | 5 |
|
||||
| **Total** | **21** | **2** | **23** |
|
||||
|
||||
### Overall Progress
|
||||
|
||||
```
|
||||
Complete: [====================] 91% (21/23)
|
||||
Partial: [== ] 9% (2/23)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Recommendations
|
||||
## Requirements.txt Coverage
|
||||
|
||||
1. **Create missing CLAUDE.md files** for skills with existing scripts (8 files needed)
|
||||
2. **Create missing requirements.txt** for skills with scripts (5 files needed)
|
||||
3. **12-seo-local-audit**: Keep as guidance-only skill (no scripts needed - uses MCP tools)
|
||||
4. **41-jamie-brand-audit**: Keep as guidance-only (uses desktop/references for review criteria)
|
||||
5. **02-notion-data-migration**: Either implement or remove from directory
|
||||
Skills with `code/scripts/requirements.txt`:
|
||||
|
||||
1. 01-ourdigital-research
|
||||
2. 02-ourdigital-designer
|
||||
3. 03-ourdigital-presentation
|
||||
4. 10-seo-technical-audit
|
||||
5. 11-seo-on-page-audit
|
||||
6. 13-seo-schema-validator
|
||||
7. 14-seo-schema-generator
|
||||
8. 15-seo-core-web-vitals
|
||||
9. 16-seo-search-console
|
||||
10. 17-seo-gateway-architect
|
||||
11. 18-seo-gateway-builder
|
||||
12. 20-gtm-audit
|
||||
13. 21-gtm-manager
|
||||
14. 31-notion-organizer
|
||||
15. 40-jamie-brand-editor
|
||||
|
||||
**All skills with scripts now have requirements.txt**
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Create desktop/SKILL.md** for:
|
||||
- 00-claude-code-setting
|
||||
- 21-gtm-manager
|
||||
|
||||
2. ~~**Add requirements.txt**~~ - Completed 2025-01-23
|
||||
|
||||
3. ~~**Archive REFACTORING_PLAN.md**~~ - Moved to `99_archive/` on 2025-01-23
|
||||
|
||||
Reference in New Issue
Block a user