ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
2aa9d098cbf9ac8f13ee511c072a87b88287ece2
our-claude-skills/CLAUDE.md
Andrew Yim 397fa2aa5d Fix SEO skills 19-34 bugs, add slash commands, enhance reference-curator (#3) 
* Fix SEO skill 34 bugs, Korean labels, and transition Ahrefs refs to our-seo-agent

P0: Fix report_aggregator.py — wrong SKILL_REGISTRY[33] mapping, missing
CATEGORY_WEIGHTS for 7 categories, and break bug in health score parsing
that exited loop even on parse failure.

P1: Remove VIEW tab references from skill 20, expand skill 32 docs,
replace Ahrefs MCP references across all 16 skills (19-28, 31-34)
with our-seo-agent CLI data source references.

P2: Fix Korean labels in executive_report.py and dashboard_generator.py,
add tenacity to base requirements, sync skill 34 base_client.py with
canonical version from skill 12.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Add Claude Code slash commands for SEO skills 19-34 and fix stale paths

Create 14 new slash command files for skills 19-28, 31-34 so they
appear as /seo-* commands in Claude Code. Also fix stale directory
paths in 8 existing commands (skills 12-18, 29-30) that referenced
pre-renumbering skill directories.

Update .gitignore to track .claude/commands/ while keeping other
.claude/ files ignored.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Add 8 slash commands, enhance reference-curator with depth/output options

- Add slash commands: ourdigital-brand-guide, notion-writer, notebooklm-agent,
  notebooklm-automation, notebooklm-studio, notebooklm-research,
  reference-curator, multi-agent-guide
- Add --depth (light/standard/deep/full) with Firecrawl parameter mapping
- Add --output with ~/Documents/reference-library/ default and user confirmation
- Increase --max-sources default from 10 to 100
- Rename /reference-curator-pipeline to /reference-curator
- Simplify web-crawler-orchestrator label to web-crawler in docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 14:12:57 +09:00

13 KiB
Raw Blame History

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/our-claude-skills

This is a Claude Skills collection repository containing:

  • custom-skills/: 52 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

Settings & Meta Tools (00)

# Skill Purpose Trigger
00 our-settings-audit Claude settings optimization & token audit "settings audit", "exceed response limit", "MCP error"

OurDigital Core (01-10)

# Skill Purpose Trigger
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 (11-34)

# Skill Purpose Trigger
11 seo-comprehensive-audit Unified 6-stage SEO audit orchestrator "comprehensive SEO", "full SEO audit"
12 seo-technical-audit Robots.txt, sitemap, crawlability "technical SEO", "crawlability"
13 seo-on-page-audit Meta tags, headings, links "on-page SEO", "meta tags"
14 seo-core-web-vitals LCP, CLS, FID, INP metrics "Core Web Vitals", "page speed"
15 seo-search-console GSC data analysis "Search Console", "rankings"
16 seo-schema-validator Structured data validation "validate schema", "JSON-LD"
17 seo-schema-generator Schema markup creation "generate schema", "create JSON-LD"
18 seo-local-audit NAP, GBP, citations "local SEO", "Google Business Profile"
19 seo-keyword-strategy Keyword expansion, intent, clustering, gaps "keyword research", "keyword strategy"
20 seo-serp-analysis Google/Naver SERP features, competitor positions "SERP analysis", "SERP features"
21 seo-position-tracking Rank monitoring, visibility scores, alerts "rank tracking", "position monitoring"
22 seo-link-building Backlink audit, toxic links, link gaps "backlink audit", "link building"
23 seo-content-strategy Content audit, decay, briefs, clusters "content strategy", "content audit"
24 seo-ecommerce Product page audit, product schema "e-commerce SEO", "product SEO"
25 seo-kpi-framework Unified KPIs, health scores, ROI "SEO KPI", "SEO performance"
26 seo-international Hreflang, content parity, multi-language "international SEO", "hreflang"
27 seo-ai-visibility AI search citations, brand radar, SOV "AI visibility", "AI search"
28 seo-knowledge-graph Entity SEO, Knowledge Panel, PAA "knowledge graph", "entity SEO"
29 seo-gateway-architect Gateway page strategy "SEO strategy", "gateway pages"
30 seo-gateway-builder Gateway page content "build gateway page"
31 seo-competitor-intel Competitor profiling, benchmarking, threats "competitor analysis", "competitive intel"
32 seo-crawl-budget Log analysis, bot profiling, crawl waste "crawl budget", "log analysis"
33 seo-migration-planner Site migration planning, redirect mapping "site migration", "domain move", "사이트 이전"
34 seo-reporting-dashboard Executive reports, HTML dashboards, aggregation "SEO report", "SEO dashboard", "보고서"

GTM/GA Tools (60-69)

# Skill Purpose Trigger
60 gtm-audit GTM container audit "audit GTM", "GTM analysis"
61 gtm-manager GTM management + dataLayer "GTM manager", "dataLayer"
62 gtm-guardian Live tag monitoring & validation "monitor GTM", "tag validation"

Notion Tools (31-39)

# Skill Purpose Trigger
31 notion-organizer Notion workspace management "organize Notion", "workspace cleanup"
32 notion-writer Content writing to Notion "write to Notion", "export to Notion"

Jamie Clinic (40-49)

# Skill Purpose Trigger
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)

# Skill Purpose Trigger
50 notebooklm-agent Q&A from notebooks with citations "ask NotebookLM", "query notebook", "노트북 질문"
51 notebooklm-automation Notebook/source/artifact management "create notebook", "add sources", "노트북 관리"
52 notebooklm-studio Content generation (podcasts, videos, quizzes) "create podcast", "generate video", "make quiz", "팟캐스트 만들기"
53 notebooklm-research Web/Drive research and source discovery "research topic", "find sources", "리서치"

Prerequisites: pip install notebooklm-py && playwright install chromium && notebooklm login

Reference Curator & Multi-Agent (90-99)

# Skill Purpose Trigger
90 reference-curator Modular skill suite for reference documentation See sub-skills below
91 multi-agent-guide Multi-agent collaboration setup "set up multi-agent", "agent guardrails"

Pipeline Orchestrator (Recommended):

Command Purpose
/reference-curator Full pipeline orchestration with QA loop handling 
# Full pipeline from topic
/reference-curator "Claude Code best practices" --max-sources 5

# From URLs (skip discovery)
/reference-curator https://docs.anthropic.com/en/docs/prompt-caching

# With auto-approve and fine-tuning output
/reference-curator "MCP servers" --auto-approve --export-format fine_tuning

Individual Sub-skills:

Skill Command Purpose
reference-discovery /reference-discovery Search & validate authoritative sources
web-crawler /web-crawler Multi-backend crawling (Firecrawl/Node/aiohttp/Scrapy)
content-repository /content-repository MySQL storage with version tracking
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

Dual-Platform Skill Structure

Each skill has two independent versions:

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

Platform Differences

Aspect code/ desktop/
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.md Format (Desktop)

---
name: skill-name-kebab-case
description: |
  Brief description of what the skill does.
  Triggers: keyword1, keyword2, 한국어 트리거.
---

# Skill Title

Content starts here...

Directory Layout

our-claude-skills/
├── custom-skills/
│   ├── _ourdigital-shared/         # Shared config, installer, dependencies
│   │
│   ├── 00-our-settings-audit/
│   │
│   ├── 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/
│   │
│   ├── 11-seo-comprehensive-audit/
│   ├── 12-seo-technical-audit/
│   ├── 13-seo-on-page-audit/
│   ├── 14-seo-core-web-vitals/
│   ├── 15-seo-search-console/
│   ├── 16-seo-schema-validator/
│   ├── 17-seo-schema-generator/
│   ├── 18-seo-local-audit/
│   ├── 19-seo-keyword-strategy/
│   ├── 20-seo-serp-analysis/
│   ├── 21-seo-position-tracking/
│   ├── 22-seo-link-building/
│   ├── 23-seo-content-strategy/
│   ├── 24-seo-ecommerce/
│   ├── 25-seo-kpi-framework/
│   ├── 26-seo-international/
│   ├── 27-seo-ai-visibility/
│   ├── 28-seo-knowledge-graph/
│   ├── 29-seo-gateway-architect/
│   ├── 30-seo-gateway-builder/
│   ├── 31-seo-competitor-intel/
│   ├── 32-seo-crawl-budget/
│   ├── 33-seo-migration-planner/
│   ├── 34-seo-reporting-dashboard/
│   │
│   ├── 60-gtm-audit/
│   ├── 61-gtm-manager/
│   ├── 62-gtm-guardian/
│   │
│   ├── 31-notion-organizer/
│   ├── 32-notion-writer/
│   │
│   ├── 40-jamie-brand-editor/
│   ├── 41-jamie-brand-audit/
│   ├── 42-jamie-journal-editor/
│   ├── 43-jamie-youtube-manager/
│   ├── 44-jamie-youtube-subtitle-checker/
│   ├── 45-jamie-instagram-manager/
│   │
│   ├── 50-notebooklm-agent/
│   ├── 51-notebooklm-automation/
│   ├── 52-notebooklm-studio/
│   ├── 53-notebooklm-research/
│   │
│   ├── 90-reference-curator/       # Modular reference documentation suite
│   │   ├── 01-reference-discovery/
│   │   ├── 02-web-crawler-orchestrator/
│   │   ├── 03-content-repository/
│   │   ├── 04-content-distiller/
│   │   ├── 05-quality-reviewer/
│   │   ├── 06-markdown-exporter/
│   │   ├── 07-pipeline-orchestrator/
│   │   ├── commands/
│   │   ├── shared/
│   │   └── install.sh
│   │
│   ├── 91-multi-agent-guide/
│   │
│   └── 99_archive/
│
├── example-skills/skills-main/
├── official-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
python example-skills/skills-main/skill-creator/scripts/init_skill.py <skill-name> --path custom-skills/

Key Reference Files

  • reference/SKILL-FORMAT-REQUIREMENTS.md - Format specification
  • example-skills/skills-main/skill-creator/SKILL.md - Skill creation guide
  • AGENTS.md - Agent routing guide for Task tool
Reference in New Issue View Git Blame Copy Permalink