our-claude-skills/CLAUDE.md

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/: 9 custom skills for OurDigital workflows, Jamie Brand, SEO tools
• 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

#	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 분석"
20	jamie-brand-editor	Jamie content generation	"write Jamie blog", "제이미 콘텐츠 생성"
21	jamie-brand-guardian	Jamie content review/evaluation	"review content", "브랜드 검토"

Jamie Skills Role Separation

• jamie-brand-editor (20): Creates NEW branded content from scratch
• jamie-brand-guardian (21): Reviews, corrects, and evaluates EXISTING content

Skill Structure

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

SKILL.md Format Requirements

All SKILL.md files MUST start with YAML frontmatter:

---
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
---

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/

Package a skill for distribution:

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/        # 9 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/
│   ├── 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