Andrew Yim
aedfa316ba
- Add GitHub repository URL - Add custom skills summary table with triggers - Clarify Jamie skills role separation (editor vs guardian) - Add version field to YAML frontmatter requirements - Update directory layout with annotations - Add allowed-tools field example 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
115 lines
4.8 KiB
Markdown
115 lines
4.8 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-factory
|
|
|
|
This is a Claude Skills collection repository containing:
|
|
- **ourdigital-custom-skills/**: 8 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
|
|
- **_jamie-reference-raw-data/**: Source materials for Jamie skills (not part of skills)
|
|
|
|
## Custom Skills Summary
|
|
|
|
| # | Skill | Purpose | Trigger |
|
|
|---|-------|---------|---------|
|
|
| 00 | ourdigital-visual-storytelling | Blog featured image prompts | "create image prompt", "블로그 이미지" |
|
|
| 01 | ourdigital-research-publisher | Research → Blog workflow | "research this", "블로그 작성" |
|
|
| 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" |
|
|
| 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:
|
|
```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
|
|
---
|
|
```
|
|
|
|
## Creating New Skills
|
|
|
|
Use the skill creator initialization script:
|
|
```bash
|
|
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/ # 8 custom skills
|
|
│ ├── 00-ourdigital-visual-storytelling/
|
|
│ ├── 01-ourdigital-research-publisher/
|
|
│ ├── 02-notion-organizer/
|
|
│ ├── 03-research-to-presentation/
|
|
│ ├── 04-seo-gateway-strategist/
|
|
│ ├── 05-gateway-page-content-builder/
|
|
│ ├── 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
|
|
└── _jamie-reference-raw-data/ # Jamie source materials
|
|
```
|
|
|
|
## 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
|