Andrew Yim
b69e4b6f3a
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>
164 lines
6.1 KiB
Markdown
164 lines
6.1 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Repository Overview
|
|
|
|
**GitHub**: https://github.com/ourdigital/claude-skills
|
|
|
|
This is a Claude Skills collection repository containing:
|
|
- **custom-skills/**: 23 custom skills for OurDigital workflows, SEO, GTM, and Jamie Brand
|
|
- **example-skills/**: Reference examples from Anthropic's official skills repository
|
|
- **official-skills/**: Notion integration skills (3rd party)
|
|
- **reference/**: Skill format requirements documentation
|
|
|
|
## Custom Skills Summary
|
|
|
|
### Claude Code Settings (00)
|
|
|
|
| # | Skill | Purpose | Trigger |
|
|
|---|-------|---------|---------|
|
|
| 00 | claude-code-setting | Settings optimization & token audit | "audit settings", "optimize Claude Code" |
|
|
|
|
### OurDigital Core Workflows (01-09)
|
|
|
|
| # | Skill | Purpose | Trigger |
|
|
|---|-------|---------|---------|
|
|
| 01 | ourdigital-research | Research → Blog workflow | "research this", "blog post" |
|
|
| 02 | ourdigital-designer | Visual storytelling, image prompts | "create image prompt", "visual design" |
|
|
| 03 | ourdigital-presentation | Notion → PPT/Figma | "create presentation" |
|
|
|
|
### SEO Tools (10-19)
|
|
|
|
| # | Skill | Purpose | Trigger |
|
|
|---|-------|---------|---------|
|
|
| 10 | seo-technical-audit | Robots.txt, sitemap, crawlability | "crawlability", "robots.txt", "sitemap" |
|
|
| 11 | seo-on-page-audit | Meta tags, headings, links | "on-page SEO", "meta tags" |
|
|
| 12 | seo-local-audit | NAP, GBP, citations | "local SEO", "Google Business Profile" |
|
|
| 13 | seo-schema-validator | Structured data validation | "validate schema", "JSON-LD" |
|
|
| 14 | seo-schema-generator | Schema markup creation | "generate schema", "create JSON-LD" |
|
|
| 15 | seo-core-web-vitals | LCP, CLS, FID, INP metrics | "Core Web Vitals", "page speed" |
|
|
| 16 | seo-search-console | GSC data analysis | "Search Console", "rankings" |
|
|
| 17 | seo-gateway-architect | Gateway page strategy | "SEO strategy", "gateway pages" |
|
|
| 18 | seo-gateway-builder | Gateway page content | "build gateway page" |
|
|
|
|
### GTM/GA Tools (20-29)
|
|
|
|
| # | Skill | Purpose | Trigger |
|
|
|---|-------|---------|---------|
|
|
| 20 | gtm-audit | GTM container audit | "audit GTM", "GTM analysis" |
|
|
| 21 | gtm-manager | GTM management + dataLayer | "GTM manager", "dataLayer" |
|
|
| 22 | gtm-guardian | Live tag monitoring & validation | "monitor GTM", "tag validation" |
|
|
|
|
### Notion Tools (31-39)
|
|
|
|
| # | Skill | Purpose | Trigger |
|
|
|---|-------|---------|---------|
|
|
| 31 | notion-organizer | Notion workspace management | "organize Notion", "workspace cleanup" |
|
|
| 32 | notion-writer | Content writing to Notion | "write to Notion", "export to Notion" |
|
|
|
|
### Jamie Clinic (40-49)
|
|
|
|
| # | Skill | Purpose | Trigger |
|
|
|---|-------|---------|---------|
|
|
| 40 | jamie-brand-editor | Content **generation** | "write Jamie blog", "Jamie content" |
|
|
| 41 | jamie-brand-audit | Content **review/evaluation** | "review content", "brand audit" |
|
|
| 42 | jamie-instagram-manager | Instagram account management | "Instagram management", "IG strategy" |
|
|
| 43 | jamie-youtube-manager | YouTube SEO audit & management | "YouTube SEO", "YT optimization" |
|
|
| 44 | jamie-youtube-subtitle-checker | YouTube subtitle validation | "check subtitles", "subtitle QA" |
|
|
|
|
## Dual-Platform Skill Structure
|
|
|
|
Each skill has two independent versions:
|
|
|
|
```
|
|
XX-skill-name/
|
|
├── code/ # Claude Code version
|
|
│ ├── CLAUDE.md # Action-oriented directive
|
|
│ ├── scripts/ # Executable Python/Bash
|
|
│ └── references/ # Documentation
|
|
│
|
|
├── desktop/ # Claude Desktop version
|
|
│ ├── SKILL.md # MCP-focused directive (YAML frontmatter)
|
|
│ ├── references/ # Guidance docs
|
|
│ └── examples/ # Usage examples
|
|
│
|
|
└── README.md # Overview (optional)
|
|
```
|
|
|
|
### Platform Differences
|
|
|
|
| Aspect | `code/` | `desktop/` |
|
|
|--------|---------|------------|
|
|
| Directive | CLAUDE.md | SKILL.md (YAML) |
|
|
| Execution | Direct Bash/Python | MCP tools only |
|
|
| Scripts | Required | Reference only |
|
|
|
|
### Development Workflow
|
|
|
|
1. **Build Claude Code version first** - Full automation with scripts
|
|
2. **Refactor to Desktop** - Extract guidance, use MCP tools
|
|
|
|
## Skill Design Principles
|
|
|
|
1. **One thing done well** - Each skill focuses on a single capability
|
|
2. **Directives under 1,500 words** - Concise, actionable
|
|
3. **Self-contained** - Each platform version is fully independent
|
|
4. **Code-first development** - Build Claude Code version first
|
|
5. **Progressive numbering** - Logical grouping by domain
|
|
|
|
## Directory Layout
|
|
|
|
```
|
|
claude-skills/
|
|
├── custom-skills/
|
|
│ ├── 00-claude-code-setting/
|
|
│ │
|
|
│ ├── 01-ourdigital-research/
|
|
│ ├── 02-ourdigital-designer/
|
|
│ ├── 03-ourdigital-presentation/
|
|
│ │
|
|
│ ├── 10-seo-technical-audit/
|
|
│ ├── 11-seo-on-page-audit/
|
|
│ ├── 12-seo-local-audit/
|
|
│ ├── 13-seo-schema-validator/
|
|
│ ├── 14-seo-schema-generator/
|
|
│ ├── 15-seo-core-web-vitals/
|
|
│ ├── 16-seo-search-console/
|
|
│ ├── 17-seo-gateway-architect/
|
|
│ ├── 18-seo-gateway-builder/
|
|
│ │
|
|
│ ├── 20-gtm-audit/
|
|
│ ├── 21-gtm-manager/
|
|
│ ├── 22-gtm-guardian/
|
|
│ │
|
|
│ ├── 31-notion-organizer/
|
|
│ ├── 32-notion-writer/
|
|
│ │
|
|
│ ├── 40-jamie-brand-editor/
|
|
│ ├── 41-jamie-brand-audit/
|
|
│ ├── 42-jamie-instagram-manager/
|
|
│ ├── 43-jamie-youtube-manager/
|
|
│ ├── 44-jamie-youtube-subtitle-checker/
|
|
│ │
|
|
│ └── 99_archive/
|
|
│
|
|
├── example-skills/skills-main/
|
|
├── official-skills/
|
|
└── reference/
|
|
```
|
|
|
|
## Creating New Skills
|
|
|
|
Use the skill creator initialization script:
|
|
```bash
|
|
python example-skills/skills-main/skill-creator/scripts/init_skill.py <skill-name> --path custom-skills/
|
|
```
|
|
|
|
## Key Reference Files
|
|
|
|
- `reference/SKILL-FORMAT-REQUIREMENTS.md` - Format specification
|
|
- `example-skills/skills-main/skill-creator/SKILL.md` - Skill creation guide
|
|
- `custom-skills/AUDIT_REPORT.md` - Skills completion status
|
|
- `custom-skills/REFACTORING_PLAN.md` - Original refactoring plan
|