New skills: - Skill 33: Site migration planner with redirect mapping and monitoring - Skill 34: Reporting dashboard with HTML charts and Korean executive reports Bug fixes (Skill 34 - report_aggregator.py): - Add audit_type fallback for skill identification (was only using audit_id prefix) - Extract health scores from nested data dict (technical_score, onpage_score, etc.) - Support subdomain matching in domain filter (blog.ourdigital.org matches ourdigital.org) - Skip self-referencing DASH- aggregated reports Bug fixes (Skill 20 - naver_serp_analyzer.py): - Remove VIEW tab selectors (removed by Naver in 2026) - Add new section detectors: books (도서), shortform (숏폼), influencer (인플루언서) Improvements (Skill 34 - dashboard/executive report): - Add Korean category labels for Chart.js charts (기술 SEO, 온페이지, etc.) - Add Korean trend labels (개선 중 ↑, 안정 →, 하락 중 ↓) - Add English→Korean issue description translation layer (20 common patterns) Documentation improvements: - Add Korean triggers to 4 skill descriptions (19, 25, 28, 31) - Expand Skill 32 SKILL.md from 40→143 lines (was 6/10, added workflow, output format, limitations) - Add output format examples to Skills 27 and 28 SKILL.md - Add limitations sections to Skills 27 and 28 - Update README.md, CLAUDE.md, AGENTS.md for skills 33-34 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
218 lines
8.3 KiB
Markdown
218 lines
8.3 KiB
Markdown
# Our Claude Skills
|
|
|
|
> **Internal R&D Repository** - This repository is restricted for internal use only.
|
|
|
|
A collection of **52 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.
|
|
|
|
## Quick Install
|
|
|
|
```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 | `our-settings-audit` | Claude settings optimization & token efficiency audit |
|
|
|
|
### OurDigital Core (01-10)
|
|
|
|
| # | Skill | Purpose |
|
|
|---|-------|---------|
|
|
| 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 (11-34)
|
|
|
|
| # | Skill | Purpose |
|
|
|---|-------|---------|
|
|
| 11 | `seo-comprehensive-audit` | Unified 6-stage SEO audit orchestrator |
|
|
| 12 | `seo-technical-audit` | Robots.txt, sitemap, crawlability |
|
|
| 13 | `seo-on-page-audit` | Meta tags, headings, links analysis |
|
|
| 14 | `seo-core-web-vitals` | LCP, CLS, FID, INP metrics |
|
|
| 15 | `seo-search-console` | GSC data analysis |
|
|
| 16 | `seo-schema-validator` | Structured data validation |
|
|
| 17 | `seo-schema-generator` | Schema markup creation |
|
|
| 18 | `seo-local-audit` | NAP consistency, GBP, Naver Smart Place, citations |
|
|
| 19 | `seo-keyword-strategy` | Keyword expansion, intent classification, clustering, gaps |
|
|
| 20 | `seo-serp-analysis` | Google/Naver SERP features, competitor positions |
|
|
| 21 | `seo-position-tracking` | Rank monitoring, visibility scores, alerts |
|
|
| 22 | `seo-link-building` | Backlink audit, toxic links, link gaps |
|
|
| 23 | `seo-content-strategy` | Content audit, decay detection, briefs, clusters |
|
|
| 24 | `seo-ecommerce` | Product page audit, product schema, Naver Smart Store |
|
|
| 25 | `seo-kpi-framework` | Unified KPIs, health scores, ROI estimation |
|
|
| 26 | `seo-international` | Hreflang validation, content parity, multi-language |
|
|
| 27 | `seo-ai-visibility` | AI search citations, brand radar, share of voice |
|
|
| 28 | `seo-knowledge-graph` | Entity SEO, Knowledge Panel, PAA, FAQ |
|
|
| 29 | `seo-gateway-architect` | Gateway page strategy (Naver/Google) |
|
|
| 30 | `seo-gateway-builder` | Gateway page content generation |
|
|
| 31 | `seo-competitor-intel` | Competitor profiling, benchmarking, threat scoring |
|
|
| 32 | `seo-crawl-budget` | Log analysis, bot profiling, crawl waste detection |
|
|
| 33 | `seo-migration-planner` | Site migration planning, redirect mapping, monitoring |
|
|
| 34 | `seo-reporting-dashboard` | Executive reports, HTML dashboards, data aggregation |
|
|
|
|
### GTM/GA Tools (60-69)
|
|
|
|
| # | Skill | Purpose |
|
|
|---|-------|---------|
|
|
| 60 | `gtm-audit` | GTM container audit with Chrome DevTools |
|
|
| 61 | `gtm-manager` | GTM management + dataLayer generation |
|
|
| 62 | `gtm-guardian` | Live tag monitoring & validation |
|
|
|
|
### Notion Tools (31-39)
|
|
|
|
| # | Skill | Purpose |
|
|
|---|-------|---------|
|
|
| 31 | `notion-organizer` | Notion workspace management |
|
|
| 32 | `notion-writer` | Content writing to Notion |
|
|
|
|
### Jamie Clinic (40-49)
|
|
|
|
| # | Skill | Purpose |
|
|
|---|-------|---------|
|
|
| 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 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 & source discovery |
|
|
|
|
**Prerequisites:** `pip install notebooklm-py && playwright install chromium && notebooklm login`
|
|
|
|
### Reference Curator & Multi-Agent (90-99)
|
|
|
|
| # | Skill | Purpose |
|
|
|---|-------|---------|
|
|
| 90 | `reference-curator` | Modular reference documentation suite (6 sub-skills) |
|
|
| 91 | `multi-agent-guide` | Multi-agent collaboration setup & guardrails |
|
|
|
|
**Reference Curator Sub-skills:**
|
|
|
|
| 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
|
|
|
|
Each skill supports both Claude Code and Claude Desktop:
|
|
|
|
```
|
|
XX-skill-name/
|
|
├── code/ # Claude Code version
|
|
│ ├── CLAUDE.md # Action-oriented directive
|
|
│ ├── scripts/ # Executable Python/Bash
|
|
│ └── docs/ # Documentation
|
|
│
|
|
├── desktop/ # Claude Desktop version
|
|
│ ├── SKILL.md # Skill directive with YAML frontmatter
|
|
│ ├── skill.yaml # Extended metadata (optional)
|
|
│ └── tools/ # MCP tool documentation
|
|
│
|
|
├── shared/ # Shared resources (optional)
|
|
└── README.md # Overview
|
|
```
|
|
|
|
## Repository Structure
|
|
|
|
```
|
|
our-claude-skills/
|
|
├── custom-skills/
|
|
│ ├── _ourdigital-shared/ # Shared config, installer, dependencies
|
|
│ │
|
|
│ ├── 00-our-settings-audit/
|
|
│ ├── 01-10 (OurDigital core)
|
|
│ ├── 11-34 (SEO tools)
|
|
│ ├── 60-62 (GTM/GA tools)
|
|
│ ├── 31-32 (Notion tools)
|
|
│ ├── 40-45 (Jamie clinic)
|
|
│ ├── 50-53 (NotebookLM tools)
|
|
│ ├── 90-reference-curator/
|
|
│ ├── 91-multi-agent-guide/
|
|
│ └── 99_archive/
|
|
│
|
|
├── example-skills/ # Anthropic reference examples
|
|
├── official-skills/ # 3rd party skills (Notion)
|
|
├── reference/ # Skill format documentation
|
|
├── .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
|
|
|
|
### Claude Code
|
|
|
|
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/
|
|
```
|
|
|
|
---
|
|
|
|
**OurDigital** | Internal Use Only
|