ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor(skills): Restructure skills to dual-platform architecture

Browse Source 
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>
This commit is contained in:
Andrew Yim
2025-12-22 01:58:24 +09:00
parent 214247ace2
commit eea49f9f8c
251 changed files with 12308 additions and 102 deletions
Download Patch File Download Diff File Expand all files Collapse all files

192
CLAUDE.md
View File

@@ -7,59 +7,129 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
**GitHub**: https://github.com/ourdigital/claude-skills-factory
This is a Claude Skills collection repository containing:
- **ourdigital-custom-skills/**: 11 custom skills for OurDigital workflows, Jamie Brand, SEO/GTM tools
- **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 |
|---|-------|---------|---------|
| 02 | notion-organizer | Notion workspace management | "organize Notion", "노션 정리" |
| 03 | research-to-presentation | Notion → PPT/Figma | "create presentation from Notion" |
| 04 | seo-gateway-strategist | SEO gateway page strategy | "SEO strategy", "게이트웨이 전략" |
| 05 | gateway-page-content-builder | Gateway page content generation | "build gateway page" |
| 10 | ourdigital-visual-storytelling | Blog featured image prompts | "create image prompt", "블로그 이미지" |
| 11 | ourdigital-research-publisher | Research → Blog workflow | "research this", "블로그 작성" |
| 12 | ourdigital-seo-audit | Comprehensive SEO audit | "SEO audit", "사이트 SEO 분석" |
| 13 | ourdigital-gtm-audit | Lightweight GTM audit | "audit GTM", "GTM 검사" |
| 14 | ourdigital-gtm-manager | GTM management + dataLayer injection | "GTM manager", "dataLayer 태그 생성" |
| 20 | jamie-brand-editor | Jamie content **generation** | "write Jamie blog", "제이미 콘텐츠 생성" |
| 21 | jamie-brand-guardian | Jamie content **review/evaluation** | "review content", "브랜드 검토" |
| 01 | notion-organizer | Notion workspace management | "organize Notion", "노션 정리" |
| 02 | notion-data-migration | Database migration tools | "migrate Notion data" |
### Jamie Skills Role Separation
- **jamie-brand-editor (20)**: Creates NEW branded content from scratch
- **jamie-brand-guardian (21)**: Reviews, corrects, and evaluates EXISTING content
### SEO Tools (10-19)
### GTM Skills Role Separation
- **ourdigital-gtm-audit (13)**: Lightweight audit-only (container, dataLayer, forms, checkout)
- **ourdigital-gtm-manager (14)**: Comprehensive management (audit + dataLayer tag generation + Notion export)
| # | 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" |
## Skill Structure
### 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:
Every skill must follow this structure:
```
skill-name/
├── SKILL.md (required) # YAML frontmatter + instructions
├── scripts/ # Executable code (Python/Bash)
├── references/ # Documentation loaded as needed
├── assets/ # Templates, images, fonts
├── templates/ # Output templates (HTML, MD)
└── examples/ # Usage examples
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)
```
### SKILL.md Format Requirements
### Platform Differences
All SKILL.md files MUST start with YAML frontmatter:
```yaml
---
name: skill-name-here # lowercase with hyphens, required
version: 1.0.0 # semantic versioning, required
description: Description # when Claude should use this skill, required
license: MIT # or "Internal-use Only"
allowed-tools: Tool1, Tool2 # optional, restrict tool access
---
| 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-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
@@ -69,54 +139,8 @@ Use the skill creator initialization script:
python claude-skills-examples/skills-main/skill-creator/scripts/init_skill.py <skill-name> --path ourdigital-custom-skills/
```
Package a skill for distribution:
```bash
python claude-skills-examples/skills-main/skill-creator/scripts/package_skill.py <path/to/skill-folder>
```
## Skill Design Principles
1. **Progressive Disclosure**: Skills use three-level loading:
- Metadata (name + description) - always in context (~100 words)
- SKILL.md body - when skill triggers (<5k words)
- Bundled resources - as needed by Claude
2. **Writing Style**: Use imperative/infinitive form (verb-first), not second person. Write for AI consumption.
3. **Resource Organization**:
- `scripts/` - Executable code (Python/Bash/JS)
- `references/` - Documentation Claude reads while working
- `templates/` - Output templates (HTML, MD, CSS)
- `assets/` - Resources (images, fonts) not loaded into context
- `examples/` - Usage examples and sample outputs
## Directory Layout
```
claude-skills-factory/
├── ourdigital-custom-skills/ # 11 custom skills
│ ├── 02-notion-organizer/
│ ├── 03-research-to-presentation/
│ ├── 04-seo-gateway-strategist/
│ ├── 05-gateway-page-content-builder/
│ ├── 10-ourdigital-visual-storytelling/
│ ├── 11-ourdigital-research-publisher/
│ ├── 12-ourdigital-seo-audit/
│ ├── 13-ourdigital-gtm-audit/ # Lightweight GTM audit
│ ├── 14-ourdigital-gtm-manager/ # GTM management + injection
│ ├── 20-jamie-brand-editor/ # Content GENERATION
│ └── 21-jamie-brand-guardian/ # Content REVIEW
├── claude-skills-examples/skills-main/ # Anthropic examples
│ ├── skill-creator/
│ ├── document-skills/
│ ├── algorithmic-art/
│ └── ...
├── official-skils-collection/ # 3rd party Notion skills
└── reference/ # Format documentation
```
## Key Reference Files
- `reference/SKILL-FORMAT-REQUIREMENTS.md` - Format specification
- `claude-skills-examples/skills-main/skill-creator/SKILL.md` - Skill creation guide
- `claude-skills-examples/skills-main/README.md` - Official skills documentation
- `ourdigital-custom-skills/REFACTORING_PLAN.md` - Current refactoring plan