our-claude-skills/CLAUDE.md

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/: 30 custom skills for OurDigital workflows, SEO, GTM, Jamie Brand, 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)

#	Skill	Purpose	Trigger
00	our-settings-audit	Error diagnosis & token optimization (8 categories)	"settings audit", "exceed response limit", "MCP error"

OurDigital Core Workflows (01-09)

#	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"

SEO Tools (10-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"
14	seo-schema-generator	Schema markup creation	"generate schema", "create JSON-LD"
15	seo-core-web-vitals	LCP, CLS, FID, INP metrics	"Core Web Vitals", "page speed"
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"

GTM/GA Tools (20-29)

#	Skill	Purpose	Trigger
20	gtm-audit	GTM container audit	"audit GTM", "GTM analysis"
21	gtm-manager	GTM management + dataLayer	"GTM manager", "dataLayer"
22	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	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"
43	jamie-youtube-manager	YouTube SEO audit & management	"YouTube SEO", "YT optimization"
44	jamie-youtube-subtitle-checker	YouTube subtitle validation	"check subtitles", "subtitle QA"

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-pipeline	Full pipeline orchestration with QA loop handling

# Full pipeline from topic
/reference-curator-pipeline "Claude Code best practices" --max-sources 5

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

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

Individual Sub-skills (installed via ./install.sh):

Skill	Command	Purpose
reference-discovery	/reference-discovery	Search & validate authoritative sources
web-crawler-orchestrator	/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
pipeline-orchestrator	/reference-curator-pipeline	Full 6-skill workflow orchestration

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
│   └── references/          # 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
│
└── README.md                # Overview (optional)

Platform Differences

Aspect	code/	desktop/
Directive	CLAUDE.md	SKILL.md (content)
Metadata	In CLAUDE.md	skill.yaml
Tool docs	N/A	tools/ directory
Execution	Direct Bash/Python	MCP tools only
Scripts	Required	Reference only

skill.yaml Schema

# Required fields
name: string              # Skill identifier
description: string       # Trigger description (can be multi-line with |)

# 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

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/
│   ├── 00-our-settings-audit/
│   │
│   ├── 01-ourdigital-research/
│   ├── 02-ourdigital-designer/
│   ├── 03-ourdigital-presentation/
│   │
│   ├── 10-seo-technical-audit/
│   ├── 11-seo-on-page-audit/
│   ├── 12-seo-local-audit/
│   ├── 13-seo-schema-validator/
│   ├── 14-seo-schema-generator/
│   ├── 15-seo-core-web-vitals/
│   ├── 16-seo-search-console/
│   ├── 17-seo-gateway-architect/
│   ├── 18-seo-gateway-builder/
│   │
│   ├── 20-gtm-audit/
│   ├── 21-gtm-manager/
│   ├── 22-gtm-guardian/
│   │
│   ├── 31-notion-organizer/
│   ├── 32-notion-writer/
│   │
│   ├── 40-jamie-brand-editor/
│   ├── 41-jamie-brand-audit/
│   ├── 42-jamie-instagram-manager/
│   ├── 43-jamie-youtube-manager/
│   ├── 44-jamie-youtube-subtitle-checker/
│   │
│   ├── 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
│   │
│   ├── 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
│   │
│   └── 99_archive/
│
├── example-skills/skills-main/
├── official-skills/
└── reference/

Creating New Skills

Use the skill creator initialization script:

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
• custom-skills/AUDIT_REPORT.md - Skills completion status
• AGENTS.md - Agent routing guide for Task tool