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

docs: Comprehensive README and CLAUDE.md update for 37 skills

Browse Source 
- Audit and document all custom skills (was 30, now 37)
- Add OurDigital Core skills 01-10 (previously undocumented)
- Add shared environment documentation with credentials table
- Update directory layout with all skill numbers
- Add Quick Install section to README
- Add NotebookLM tools (50-59) documentation with prerequisites
- Update triggers for all skills in CLAUDE.md
- Add dual-platform architecture documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Andrew Yim
2026-02-03 19:16:03 +07:00
parent 41f7bafcce
commit 912d0e2810
2 changed files with 187 additions and 120 deletions
Download Patch File Download Diff File Expand all files Collapse all files

145
CLAUDE.md
View File

@@ -7,32 +7,38 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
**GitHub**: https://github.com/ourdigital/our-claude-skills
This is a Claude Skills collection repository containing:
- **custom-skills/**: 34 custom skills for OurDigital workflows, SEO, GTM, Jamie Brand, NotebookLM, Reference Curation, and Multi-Agent Collaboration
- **custom-skills/**: 37 custom skills for OurDigital workflows, SEO, GTM, Jamie Brand, NotebookLM, Notion, Reference Curation, and Multi-Agent Collaboration
- **example-skills/**: Reference examples from Anthropic's official skills repository
- **official-skills/**: Notion integration skills (3rd party)
- **reference/**: Skill format requirements documentation
## Custom Skills Summary
### Claude Settings Audit (00)
### Settings & Meta Tools (00)
| # | Skill | Purpose | Trigger |
|---|-------|---------|---------|
| 00 | our-settings-audit | Error diagnosis & token optimization (8 categories) | "settings audit", "exceed response limit", "MCP error" |
| 00 | our-settings-audit | Claude settings optimization & token audit | "settings audit", "exceed response limit", "MCP error" |
### OurDigital Core Workflows (01-09)
### OurDigital Core (01-10)
| # | Skill | Purpose | Trigger |
|---|-------|---------|---------|
| 01 | ourdigital-research | Research → Blog workflow | "research this", "blog post" |
| 02 | ourdigital-designer | Visual storytelling, image prompts | "create image prompt", "visual design" |
| 03 | ourdigital-presentation | Notion → PPT/Figma | "create presentation" |
| 01 | ourdigital-brand-guide | Brand standards & writing style reference | "brand guide", "writing style" |
| 02 | ourdigital-blog | Korean blog creation (blog.ourdigital.org) | "write blog post", "블로그 작성" |
| 03 | ourdigital-journal | English essay/article (journal.ourdigital.org) | "write essay", "journal article" |
| 04 | ourdigital-research | Research → Blog workflow | "research this", "blog post" |
| 05 | ourdigital-document | Notion → Presentation workflow | "create document", "Notion export" |
| 06 | ourdigital-designer | Visual storytelling, image prompts | "create image prompt", "visual design" |
| 07 | ourdigital-ad-manager | Ad copywriting & keyword research | "ad copy", "keyword research" |
| 08 | ourdigital-trainer | Training material creation | "create training", "교육 자료" |
| 09 | ourdigital-backoffice | Business document creation | "create proposal", "견적서" |
| 10 | ourdigital-skill-creator | Meta skill for creating skills | "create skill", "init skill" |
### SEO Tools (10-19)
### SEO Tools (11-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" |
@@ -41,6 +47,7 @@ This is a Claude Skills collection repository containing:
| 16 | seo-search-console | GSC data analysis | "Search Console", "rankings" |
| 17 | seo-gateway-architect | Gateway page strategy | "SEO strategy", "gateway pages" |
| 18 | seo-gateway-builder | Gateway page content | "build gateway page" |
| 19 | seo-technical-audit | Robots.txt, sitemap, crawlability | "technical SEO", "crawlability" |
### GTM/GA Tools (20-29)
@@ -61,11 +68,12 @@ This is a Claude Skills collection repository containing:
| # | Skill | Purpose | Trigger |
|---|-------|---------|---------|
| 40 | jamie-brand-editor | Content **generation** | "write Jamie blog", "Jamie content" |
| 41 | jamie-brand-audit | Content **review/evaluation** | "review content", "brand audit" |
| 42 | jamie-instagram-manager | Instagram account management | "Instagram management", "IG strategy" |
| 40 | jamie-brand-editor | Branded content generation | "write Jamie blog", "Jamie content" |
| 41 | jamie-brand-audit | Content review/compliance | "review content", "brand audit" |
| 42 | jamie-journal-editor | Clinic journal editing | "Jamie journal", "진료 일지" |
| 43 | jamie-youtube-manager | YouTube SEO audit & management | "YouTube SEO", "YT optimization" |
| 44 | jamie-youtube-subtitle-checker | YouTube subtitle validation | "check subtitles", "subtitle QA" |
| 45 | jamie-instagram-manager | Instagram account management | "Instagram management", "IG strategy" |
### NotebookLM Tools (50-59)
@@ -91,7 +99,7 @@ This is a Claude Skills collection repository containing:
|---------|---------|
| `/reference-curator-pipeline` | Full pipeline orchestration with QA loop handling |
```
```bash
# Full pipeline from topic
/reference-curator-pipeline "Claude Code best practices" --max-sources 5
@@ -102,7 +110,7 @@ This is a Claude Skills collection repository containing:
/reference-curator-pipeline "MCP servers" --auto-approve --export-format fine_tuning
```
**Individual Sub-skills (installed via `./install.sh`):**
**Individual Sub-skills:**
| Skill | Command | Purpose |
|-------|---------|---------|
@@ -112,7 +120,6 @@ This is a Claude Skills collection repository containing:
| content-distiller | `/content-distiller` | Summarization & key concept extraction |
| quality-reviewer | `/quality-reviewer` | QA loop with approve/refactor/research routing |
| markdown-exporter | `/markdown-exporter` | Export to markdown or JSONL for fine-tuning |
| pipeline-orchestrator | `/reference-curator-pipeline` | Full 6-skill workflow orchestration |
## Dual-Platform Skill Structure
@@ -123,71 +130,62 @@ XX-skill-name/
├── code/ # Claude Code version
│ ├── CLAUDE.md # Action-oriented directive
│ ├── scripts/ # Executable Python/Bash
│ └── references/ # Documentation
│ └── docs/ # Documentation
│
├── desktop/ # Claude Desktop version
│ ├── skill.yaml # Metadata (name, description, allowed-tools, license)
│ ├── SKILL.md # MCP-focused directive (content only, no frontmatter)
│ ├── tools/ # MCP tool documentation & configs
│ │ ├── {tool-name}.md # Tool usage docs (e.g., firecrawl.md)
│ │ └── {tool-name}.yaml # Tool config (optional)
│ ├── references/ # Guidance docs
│ └── examples/ # Usage examples
│ ├── SKILL.md # Skill directive with YAML frontmatter
│ ├── skill.yaml # Extended metadata (optional)
│ └── tools/ # MCP tool documentation
│
└── README.md # Overview (optional)
├── shared/ # Shared resources (optional)
└── README.md # Overview
```
### Platform Differences
| Aspect | `code/` | `desktop/` |
|--------|---------|------------|
| Directive | CLAUDE.md | SKILL.md (content) |
| Metadata | In CLAUDE.md | skill.yaml |
| Directive | CLAUDE.md | SKILL.md (with YAML frontmatter) |
| Metadata | In CLAUDE.md | skill.yaml (optional) |
| Tool docs | N/A | tools/ directory |
| Execution | Direct Bash/Python | MCP tools only |
| Scripts | Required | Reference only |
### skill.yaml Schema
### SKILL.md Format (Desktop)
```yaml
# Required fields
name: string # Skill identifier
description: string # Trigger description (can be multi-line with |)
```markdown
---
name: skill-name-kebab-case
description: |
Brief description of what the skill does.
Triggers: keyword1, keyword2, 한국어 트리거.
---
# Optional fields
allowed-tools: # List of permitted MCP/Claude tools
- mcp__firecrawl__*
- Read
- Write
license: string # MIT, Internal-use Only, etc.
triggers: [] # Explicit trigger keywords
# Skill Title
Content starts here...
```
### 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
```
our-claude-skills/
├── custom-skills/
│ ├── _ourdigital-shared/ # Shared config, installer, dependencies
│ │
│ ├── 00-our-settings-audit/
│ │
│ ├── 01-ourdigital-research/
│ ├── 02-ourdigital-designer/
│ ├── 03-ourdigital-presentation/
│ ├── 01-ourdigital-brand-guide/
│ ├── 02-ourdigital-blog/
│ ├── 03-ourdigital-journal/
│ ├── 04-ourdigital-research/
│ ├── 05-ourdigital-document/
│ ├── 06-ourdigital-designer/
│ ├── 07-ourdigital-ad-manager/
│ ├── 08-ourdigital-trainer/
│ ├── 09-ourdigital-backoffice/
│ ├── 10-ourdigital-skill-creator/
│ │
│ ├── 10-seo-technical-audit/
│ ├── 11-seo-on-page-audit/
│ ├── 12-seo-local-audit/
│ ├── 13-seo-schema-validator/
@@ -196,6 +194,7 @@ our-claude-skills/
│ ├── 16-seo-search-console/
│ ├── 17-seo-gateway-architect/
│ ├── 18-seo-gateway-builder/
│ ├── 19-seo-technical-audit/
│ │
│ ├── 20-gtm-audit/
│ ├── 21-gtm-manager/
@@ -206,32 +205,29 @@ our-claude-skills/
│ │
│ ├── 40-jamie-brand-editor/
│ ├── 41-jamie-brand-audit/
│ ├── 42-jamie-instagram-manager/
│ ├── 42-jamie-journal-editor/
│ ├── 43-jamie-youtube-manager/
│ ├── 44-jamie-youtube-subtitle-checker/
│ ├── 45-jamie-instagram-manager/
│ │
│ ├── 50-notebooklm-agent/ # Q&A with citations
│ ├── 51-notebooklm-automation/ # Notebook management
│ ├── 52-notebooklm-studio/ # Content generation
│ ├── 53-notebooklm-research/ # Research workflows
│ ├── 50-notebooklm-agent/
│ ├── 51-notebooklm-automation/
│ ├── 52-notebooklm-studio/
│ ├── 53-notebooklm-research/
│ │
│ ├── 90-reference-curator/ # Modular reference documentation suite
│ │ ├── commands/ # Claude Code slash commands
│ │ ├── 01-reference-discovery/
│ │ ├── 02-web-crawler-orchestrator/
│ │ ├── 03-content-repository/
│ │ ├── 04-content-distiller/
│ │ ├── 05-quality-reviewer/
│ │ ├── 06-markdown-exporter/
│ │ ├── 07-pipeline-orchestrator/ # Full pipeline coordination
│ │ ├── shared/ # Config templates & MySQL schema
│ │ └── install.sh # Cross-machine installer
│ │ ├── 07-pipeline-orchestrator/
│ │ ├── commands/
│ │ ├── shared/
│ │ └── install.sh
│ │
│ ├── 91-multi-agent-guide/ # Multi-agent collaboration setup
│ │ ├── SKILL.md # Main skill directive
│ │ ├── templates/ # AGENTS.md, Claude/Gemini/Codex configs
│ │ ├── scripts/ # Ownership validation
│ │ └── examples/ # Minimal setup example
│ ├── 91-multi-agent-guide/
│ │
│ └── 99_archive/
│
@@ -240,10 +236,18 @@ our-claude-skills/
└── reference/
```
## 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
## Creating New Skills
Use the skill creator initialization script:
```bash
# Use the skill creator
python example-skills/skills-main/skill-creator/scripts/init_skill.py <skill-name> --path custom-skills/
```
@@ -251,5 +255,4 @@ python example-skills/skills-main/skill-creator/scripts/init_skill.py <skill-nam
- `reference/SKILL-FORMAT-REQUIREMENTS.md` - Format specification
- `example-skills/skills-main/skill-creator/SKILL.md` - Skill creation guide
- `custom-skills/AUDIT_REPORT.md` - Skills completion status
- `AGENTS.md` - Agent routing guide for Task tool

152
README.md
View File

@@ -2,44 +2,59 @@
> **Internal R&D Repository** - This repository is restricted for internal use only.
A collection of 34 custom Claude Skills for OurDigital workflows, Jamie Plastic Surgery Clinic brand management, SEO/GTM tools, NotebookLM automation, Notion integrations, reference documentation curation, and multi-agent collaboration.
A collection of **37 custom Claude Skills** for OurDigital workflows, Jamie Plastic Surgery Clinic brand management, SEO/GTM tools, NotebookLM automation, Notion integrations, reference documentation curation, and multi-agent collaboration.
## Custom Skills (34 skills)
## Quick Install
### Claude Code Settings (00)
```bash
git clone https://github.com/ourdigital/our-claude-skills.git
cd our-claude-skills/custom-skills/_ourdigital-shared
./install.sh
```
## Custom Skills Overview
### Settings & Meta Tools (00)
| # | Skill | Purpose |
|---|-------|---------|
| 00 | `claude-code-setting` | Settings optimization & token audit |
| 00 | `our-settings-audit` | Claude settings optimization & token efficiency audit |
### OurDigital Core (01-09)
### OurDigital Core (01-10)
| # | Skill | Purpose |
|---|-------|---------|
| 01 | `ourdigital-research` | Research → Blog workflow |
| 02 | `ourdigital-designer` | Visual storytelling, image prompts |
| 03 | `ourdigital-presentation` | Notion → PPT/Figma |
| 01 | `ourdigital-brand-guide` | Brand standards, writing style, visual identity reference |
| 02 | `ourdigital-blog` | Korean blog draft creation for blog.ourdigital.org |
| 03 | `ourdigital-journal` | English essay/article creation for journal.ourdigital.org |
| 04 | `ourdigital-research` | Research → Blog workflow |
| 05 | `ourdigital-document` | Notion → Presentation workflow |
| 06 | `ourdigital-designer` | Visual storytelling, image prompts |
| 07 | `ourdigital-ad-manager` | Ad copywriting & keyword research |
| 08 | `ourdigital-trainer` | Training material creation |
| 09 | `ourdigital-backoffice` | Business document creation |
| 10 | `ourdigital-skill-creator` | Meta skill for creating/managing skills |
### SEO Tools (10-19)
### SEO Tools (11-19)
| # | Skill | Purpose |
|---|-------|---------|
| 10 | `seo-technical-audit` | Robots.txt, sitemap, crawlability |
| 11 | `seo-on-page-audit` | Meta tags, headings, links |
| 12 | `seo-local-audit` | NAP, GBP, citations |
| 11 | `seo-on-page-audit` | Meta tags, headings, links analysis |
| 12 | `seo-local-audit` | NAP consistency, GBP, citations |
| 13 | `seo-schema-validator` | Structured data validation |
| 14 | `seo-schema-generator` | Schema markup creation |
| 15 | `seo-core-web-vitals` | LCP, CLS, FID, INP metrics |
| 16 | `seo-search-console` | GSC data analysis |
| 17 | `seo-gateway-architect` | Gateway page strategy |
| 18 | `seo-gateway-builder` | Gateway page content |
| 17 | `seo-gateway-architect` | Gateway page strategy (Naver/Google) |
| 18 | `seo-gateway-builder` | Gateway page content generation |
| 19 | `seo-technical-audit` | Robots.txt, sitemap, crawlability |
### GTM/GA Tools (20-29)
| # | Skill | Purpose |
|---|-------|---------|
| 20 | `gtm-audit` | GTM container audit |
| 21 | `gtm-manager` | GTM management + dataLayer |
| 20 | `gtm-audit` | GTM container audit with Chrome DevTools |
| 21 | `gtm-manager` | GTM management + dataLayer generation |
| 22 | `gtm-guardian` | Live tag monitoring & validation |
### Notion Tools (31-39)
@@ -53,20 +68,21 @@ A collection of 34 custom Claude Skills for OurDigital workflows, Jamie Plastic
| # | Skill | Purpose |
|---|-------|---------|
| 40 | `jamie-brand-editor` | Content generation |
| 41 | `jamie-brand-audit` | Content review/evaluation |
| 42 | `jamie-instagram-manager` | Instagram account management |
| 40 | `jamie-brand-editor` | Branded content generation |
| 41 | `jamie-brand-audit` | Content review/compliance |
| 42 | `jamie-journal-editor` | Clinic journal editing |
| 43 | `jamie-youtube-manager` | YouTube SEO audit & management |
| 44 | `jamie-youtube-subtitle-checker` | YouTube subtitle validation |
| 45 | `jamie-instagram-manager` | Instagram account management |
### NotebookLM Tools (50-59)
| # | Skill | Purpose |
|---|-------|---------|
| 50 | `notebooklm-agent` | Q&A agent with source citations |
| 51 | `notebooklm-automation` | Notebook/source management |
| 50 | `notebooklm-agent` | Q&A from notebooks with source citations |
| 51 | `notebooklm-automation` | Notebook/source/artifact management |
| 52 | `notebooklm-studio` | Content generation (podcasts, videos, quizzes) |
| 53 | `notebooklm-research` | Web/Drive research workflows |
| 53 | `notebooklm-research` | Web/Drive research & source discovery |
**Prerequisites:** `pip install notebooklm-py && playwright install chromium && notebooklm login`
@@ -74,12 +90,21 @@ A collection of 34 custom Claude Skills for OurDigital workflows, Jamie Plastic
| # | Skill | Purpose |
|---|-------|---------|
| 90 | `reference-curator` | Modular skill suite (6 sub-skills) |
| 91 | `multi-agent-guide` | Multi-agent collaboration setup |
| 90 | `reference-curator` | Modular reference documentation suite (6 sub-skills) |
| 91 | `multi-agent-guide` | Multi-agent collaboration setup & guardrails |
**Reference Curator Sub-skills:** `reference-discovery`, `web-crawler-orchestrator`, `content-repository`, `content-distiller`, `quality-reviewer`, `markdown-exporter`
**Reference Curator Sub-skills:**
**Installation:** `cd custom-skills/90-reference-curator && ./install.sh`
| Sub-skill | Purpose |
|-----------|---------|
| `reference-discovery` | Search & validate authoritative sources |
| `web-crawler-orchestrator` | Multi-backend crawling (Firecrawl/Node/aiohttp/Scrapy) |
| `content-repository` | MySQL storage with version tracking |
| `content-distiller` | Summarization & key concept extraction |
| `quality-reviewer` | QA loop with approve/refactor/research routing |
| `markdown-exporter` | Export to markdown or JSONL for fine-tuning |
**Pipeline Command:** `/reference-curator-pipeline "topic" --max-sources 5`
## Dual-Platform Architecture
@@ -90,13 +115,14 @@ XX-skill-name/
├── code/ # Claude Code version
│ ├── CLAUDE.md # Action-oriented directive
│ ├── scripts/ # Executable Python/Bash
│ └── references/ # Documentation
│ └── docs/ # Documentation
│
├── desktop/ # Claude Desktop version
│ ├── SKILL.md # MCP-focused directive
│ ├── references/ # Guidance docs
│ └── examples/ # Usage examples
│ ├── SKILL.md # Skill directive with YAML frontmatter
│ ├── skill.yaml # Extended metadata (optional)
│ └── tools/ # MCP tool documentation
│
├── shared/ # Shared resources (optional)
└── README.md # Overview
```
@@ -104,34 +130,72 @@ XX-skill-name/
```
our-claude-skills/
├── custom-skills/ # 30 custom skills for production use
│ ├── 00-claude-code-setting/
│ ├── 01-ourdigital-research/
│ ├── 02-ourdigital-designer/
│ ├── 03-ourdigital-presentation/
│ ├── 10-19 (SEO tools)
├── custom-skills/
│ ├── _ourdigital-shared/ # Shared config, installer, dependencies
│ │
│ ├── 00-our-settings-audit/
│ ├── 01-10 (OurDigital core)
│ ├── 11-19 (SEO tools)
│ ├── 20-22 (GTM/GA tools)
│ ├── 31-32 (Notion tools)
│ ├── 40-44 (Jamie clinic)
│ ├── 40-45 (Jamie clinic)
│ ├── 50-53 (NotebookLM tools)
│ ├── 90-reference-curator/ # Reference documentation suite
│ ├── 91-multi-agent-guide/ # Multi-agent collaboration setup
│ ├── 90-reference-curator/
│ ├── 91-multi-agent-guide/
│ └── 99_archive/
│
├── example-skills/ # Anthropic reference examples
├── official-skills/ # 3rd party Notion skills
├── official-skills/ # 3rd party skills (Notion)
├── reference/ # Skill format documentation
├── .claude/ # Claude Code commands
│ └── commands/ # Slash command definitions
├── .claude/commands/ # Slash command definitions
├── CLAUDE.md # Development guidelines
├── AGENTS.md # Agent routing guide
└── README.md # This file
```
## Shared Environment
The `_ourdigital-shared/` directory provides:
- **install.sh** - Cross-machine installer
- **.env.ourdigital.template** - Environment variables template
- **requirements/** - Python dependencies (base, code)
- **scripts/** - Validation utilities
### Required Credentials
| Service | Variable | Purpose |
|---------|----------|---------|
| Notion | `NOTION_API_TOKEN` | Notion API access |
| Ghost Blog | `GHOST_BLOG_ADMIN_KEY` | blog.ourdigital.org |
| Ghost Journal | `GHOST_JOURNAL_ADMIN_KEY` | journal.ourdigital.org |
| Figma | `FIGMA_ACCESS_TOKEN` | Design integration |
## Usage
Skills are installed in Claude Code or Claude Desktop by adding the skill folder path to settings.
### Claude Code
See `CLAUDE.md` for detailed documentation on skill structure and development guidelines.
Skills are auto-detected via symlinks in `~/.claude/skills/`:
```bash
# Install skill symlink
ln -sf /path/to/skill/desktop ~/.claude/skills/skill-name
```
### Claude Desktop
Copy the `desktop/SKILL.md` file to your Claude Desktop skills folder.
## Development
See `CLAUDE.md` for detailed skill development guidelines and `AGENTS.md` for agent routing recommendations.
### Creating New Skills
```bash
# Use the skill creator
python example-skills/skills-main/skill-creator/scripts/init_skill.py <name> --path custom-skills/
```
---