Andrew Yim
eea49f9f8c
Major refactoring of ourdigital-custom-skills with new numbering system: ## Structure Changes - Each skill now has code/ (Claude Code) and desktop/ (Claude Desktop) versions - New progressive numbering: 01-09 General, 10-19 SEO, 20-29 GTM, 30-39 OurDigital, 40-49 Jamie ## Skill Reorganization - 01-notion-organizer (from 02) - 10-18: SEO tools split into focused skills (technical, on-page, local, schema, vitals, gsc, gateway) - 20-21: GTM audit and manager - 30-32: OurDigital designer, research, presentation - 40-41: Jamie brand editor and audit ## New Files - .claude/commands/: Slash command definitions for all skills - CLAUDE.md: Updated with new skill structure documentation - REFACTORING_PLAN.md: Migration documentation - COMPATIBILITY_REPORT.md, SKILLS_COMPARISON.md: Analysis docs ## Removed - Old skill directories (02-05, 10-14, 20-21 old numbering) - Consolidated into new structure with _archive/ for reference 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
5.4 KiB
5.4 KiB
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-factory
This is a Claude Skills collection repository containing:
- ourdigital-custom-skills/: 18 custom skills for OurDigital workflows, SEO, GTM, and Jamie Brand
- claude-skills-examples/: Reference examples from Anthropic's official skills repository
- official-skils-collection/: Notion integration skills (3rd party)
- reference/: Skill format requirements documentation
Custom Skills Summary
General Automation (01-09)
| # | Skill | Purpose | Trigger |
|---|---|---|---|
| 01 | notion-organizer | Notion workspace management | "organize Notion", "노션 정리" |
| 02 | notion-data-migration | Database migration tools | "migrate Notion data" |
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", "게이트웨이 전략" |
| 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 검사" |
| 21 | gtm-manager | GTM management + dataLayer | "GTM manager", "dataLayer" |
OurDigital Channel (30-39)
| # | Skill | Purpose | Trigger |
|---|---|---|---|
| 30 | ourdigital-designer | Visual storytelling, image prompts | "create image prompt", "블로그 이미지" |
| 31 | ourdigital-research | Research → Blog workflow | "research this", "블로그 작성" |
| 32 | ourdigital-presentation | Notion → PPT/Figma | "create presentation" |
Jamie Clinic (40-49)
| # | Skill | Purpose | Trigger |
|---|---|---|---|
| 40 | jamie-brand-editor | Content generation | "write Jamie blog", "제이미 콘텐츠" |
| 41 | jamie-brand-audit | Content review/evaluation | "review content", "브랜드 검토" |
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
- Build Claude Code version first - Full automation with scripts
- Refactor to Desktop - Extract guidance, use MCP tools
Skill Design Principles
- One thing done well - Each skill focuses on a single capability
- Directives under 1,500 words - Concise, actionable
- Self-contained - Each platform version is fully independent
- Code-first development - Build Claude Code version first
- Progressive numbering - Logical grouping by domain
Directory Layout
claude-skills-factory/
├── ourdigital-custom-skills/
│ ├── 01-notion-organizer/
│ ├── 02-notion-data-migration/
│ │
│ ├── 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/
│ │
│ ├── 30-ourdigital-designer/
│ ├── 31-ourdigital-research/
│ ├── 32-ourdigital-presentation/
│ │
│ ├── 40-jamie-brand-editor/
│ ├── 41-jamie-brand-audit/
│ │
│ └── _archive/
│
├── claude-skills-examples/skills-main/
├── official-skils-collection/
└── reference/
Creating New Skills
Use the skill creator initialization script:
python claude-skills-examples/skills-main/skill-creator/scripts/init_skill.py <skill-name> --path ourdigital-custom-skills/
Key Reference Files
reference/SKILL-FORMAT-REQUIREMENTS.md- Format specificationclaude-skills-examples/skills-main/skill-creator/SKILL.md- Skill creation guideourdigital-custom-skills/REFACTORING_PLAN.md- Current refactoring plan