ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
41f7bafccef43f49e70c1c381d0af3bc3e1d66bd
our-claude-skills/CLAUDE.md
Andrew Yim 41f7bafcce docs: Update README, CLAUDE, and AGENTS for NotebookLM skills 
- Update skill count from 30 to 34
- Add NotebookLM Tools section (50-59) with 4 skills
- Add NotebookLM agent routing guide in AGENTS.md
- Update directory layout to include 50-53

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 19:10:16 +07:00

256 lines
11 KiB
Markdown
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/**: 34 custom skills for OurDigital workflows, SEO, GTM, Jamie Brand, NotebookLM, 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" |
### 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-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
```yaml
# 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/
│ │
│ ├── 50-notebooklm-agent/ # Q&A with citations
│ ├── 51-notebooklm-automation/ # Notebook management
│ ├── 52-notebooklm-studio/ # Content generation
│ ├── 53-notebooklm-research/ # Research workflows
│ │
│ ├── 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:
```bash
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
Reference in New Issue View Git Blame Copy Permalink