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

162
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
├── reference/ # Skill format documentation
├── .claude/ # Claude Code commands
│ └── commands/ # Slash command definitions
├── CLAUDE.md # Development guidelines
├── AGENTS.md # Agent routing guide
└── README.md # This file
│
├── 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
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/
```
---