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

docs: Update CLAUDE.md with comprehensive skill documentation

Browse Source 
- 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>
This commit is contained in:
Andrew Yim
2025-12-10 18:01:16 +09:00
parent 341d5f5a5b
commit aedfa316ba
1 changed files with 51 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files

86
CLAUDE.md
View File

@@ -4,11 +4,31 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## Repository Overview ## Repository Overview
**GitHub**: https://github.com/ourdigital/claude-skills-factory
This is a Claude Skills collection repository containing: This is a Claude Skills collection repository containing:
- **ourdigital-custom-skills/**: Organization-specific skills (OurDigital workflows, Jamie Brand, SEO tools) - **ourdigital-custom-skills/**: 8 custom skills for OurDigital workflows, Jamie Brand, SEO tools
- **claude-skills-examples/**: Reference examples from Anthropic's official skills repository - **claude-skills-examples/**: Reference examples from Anthropic's official skills repository
- **official-skills-collection/**: Notion integration skills and other 3rd party examples - **official-skils-collection/**: Notion integration skills (3rd party)
- **reference/**: Format requirements documentation - **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 ## Skill Structure
@@ -29,12 +49,10 @@ All SKILL.md files MUST start with YAML frontmatter:
```yaml ```yaml
--- ---
name: skill-name-here # lowercase with hyphens, required name: skill-name-here # lowercase with hyphens, required
version: 1.0.0 # semantic versioning version: 1.0.0 # semantic versioning, required
description: Description # when Claude should use this skill, required description: Description # when Claude should use this skill, required
author: Author Name license: MIT # or "Internal-use Only"
tags: allowed-tools: Tool1, Tool2 # optional, restrict tool access
- tag1
- tag2
--- ---
``` ```
@@ -42,7 +60,7 @@ tags:
Use the skill creator initialization script: Use the skill creator initialization script:
```bash ```bash
python claude-skills-examples/skills-main/skill-creator/scripts/init_skill.py <skill-name> --path <output-directory> python claude-skills-examples/skills-main/skill-creator/scripts/init_skill.py <skill-name> --path ourdigital-custom-skills/
``` ```
Package a skill for distribution: Package a skill for distribution:
@@ -60,39 +78,37 @@ python claude-skills-examples/skills-main/skill-creator/scripts/package_skill.py
2. **Writing Style**: Use imperative/infinitive form (verb-first), not second person. Write for AI consumption. 2. **Writing Style**: Use imperative/infinitive form (verb-first), not second person. Write for AI consumption.
3. **Resource Organization**: 3. **Resource Organization**:
- `scripts/` - For repeatedly rewritten or deterministic code - `scripts/` - Executable code (Python/Bash/JS)
- `references/` - For documentation Claude reads while working (keep >10k word files searchable via grep patterns) - `references/` - Documentation Claude reads while working
- `assets/` - For output resources (templates, images) not loaded into context - `templates/` - Output templates (HTML, MD, CSS)
- `assets/` - Resources (images, fonts) not loaded into context
- `examples/` - Usage examples and sample outputs
## Directory Layout ## Directory Layout
``` ```
ourdigital-custom-skills/ # Production custom skills claude-skills-factory/
├── 00-ourdigital-visual-storytelling/ # Blog featured image prompts ├── ourdigital-custom-skills/ # 8 custom skills
├── 01-ourdigital-research-publisher/ # Research-to-publication workflow │ ├── 00-ourdigital-visual-storytelling/
├── 02-notion-organizer/ # Notion workspace management │ ├── 01-ourdigital-research-publisher/
├── 03-research-to-presentation/ # Research to slides (legacy format) │ ├── 02-notion-organizer/
├── 04-seo-gateway-strategist/ # SEO gateway page planning │ ├── 03-research-to-presentation/
├── 05-gateway-page-content-builder/ # Gateway page content generation │ ├── 04-seo-gateway-strategist/
├── 20-jamie-brand-editor/ # Jamie Clinic content editor │ ├── 05-gateway-page-content-builder/
└── 21-jamie-brand-guardian/ # Jamie Clinic brand compliance │ ├── 20-jamie-brand-editor/ # Content GENERATION
│ └── 21-jamie-brand-guardian/ # Content REVIEW
claude-skills-examples/skills-main/ # Anthropic reference examples ├── claude-skills-examples/skills-main/ # Anthropic examples
├── skill-creator/ # Meta skill for creating skills │ ├── skill-creator/
├── document-skills/ # docx, pdf, pptx, xlsx manipulation │ ├── document-skills/
├── algorithmic-art/ # p5.js generative art │ ├── algorithmic-art/
├── mcp-builder/ # MCP server creation guide │ └── ...
└── webapp-testing/ # Playwright testing ├── official-skils-collection/ # 3rd party Notion skills
├── reference/ # Format documentation
official-skills-collection/ # 3rd party skills └── _jamie-reference-raw-data/ # Jamie source materials
├── notion-meeting-intelligence/
├── notion-research-documentation/
├── notion-knowledge-capture/
└── notion-spec-to-implementation/
``` ```
## Key Reference Files ## Key Reference Files
- `reference/SKILL-FORMAT-REQUIREMENTS.md` - Format specification - `reference/SKILL-FORMAT-REQUIREMENTS.md` - Format specification
- `claude-skills-examples/skills-main/skill-creator/SKILL.md` - Comprehensive skill creation guide - `claude-skills-examples/skills-main/skill-creator/SKILL.md` - Skill creation guide
- `claude-skills-examples/skills-main/README.md` - Official skills documentation - `claude-skills-examples/skills-main/README.md` - Official skills documentation