Files
our-claude-skills/custom-skills/_ourdigital-shared
Andrew Yim d2d0a2d460 Add SEO skills 33-34 and fix bugs in skills 19-34
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>
2026-02-14 00:01:00 +09:00
..

OurDigital Shared Environment

Shared configuration, dependencies, and installation tools for OurDigital Skills package.

Quick Install

# Clone the repository (on new machine)
git clone https://github.com/ourdigital/our-claude-skills.git
cd our-claude-skills/custom-skills/_ourdigital-shared

# Run installer
./install.sh

Installation Options

./install.sh                  # Full interactive install
./install.sh --update         # Update existing installation
./install.sh --uninstall      # Remove installation
./install.sh --validate       # Check installation status
./install.sh --skip-creds     # Skip credentials setup
./install.sh --skip-venv      # Skip virtual environment
./install.sh --help           # Show all options

What Gets Installed

Component Location Description
Environment file ~/.env.ourdigital API keys and secrets
Config directory ~/.ourdigital/ Configuration and credentials
Virtual environment .venv-ourdigital/ Python dependencies

Directory Structure

~/.ourdigital/
├── config.yaml           # Global configuration
├── credentials/          # Service account JSONs
│   └── *.json
└── logs/                 # Installation logs

~/.env.ourdigital         # Environment variables (chmod 600)

Manual Setup

If you prefer manual setup:

1. Create directories

mkdir -p ~/.ourdigital/credentials
chmod 700 ~/.ourdigital ~/.ourdigital/credentials

2. Copy environment template

cp .env.ourdigital.template ~/.env.ourdigital
chmod 600 ~/.env.ourdigital

3. Edit credentials

nano ~/.env.ourdigital
# Add your API keys

4. Create virtual environment

python3 -m venv .venv-ourdigital
source .venv-ourdigital/bin/activate
pip install -r requirements/base.txt

Credentials Required

Service Variable How to Get
Notion NOTION_API_TOKEN Notion Integrations
Ghost Blog GHOST_BLOG_ADMIN_KEY Ghost Admin → Integrations
Ghost Journal GHOST_JOURNAL_ADMIN_KEY Ghost Admin → Integrations
Figma FIGMA_ACCESS_TOKEN Figma Settings

Using 1Password CLI

If you have 1Password CLI (op) installed:

# Sign in
eval $(op signin)

# Installer will auto-fetch credentials
./install.sh

Validation

Check your installation status:

# Quick check
./install.sh --validate

# Detailed check
python scripts/validate_install.py --verbose

Cross-Machine Sync

To sync skills to another machine:

# On new machine
git clone https://github.com/ourdigital/our-claude-skills.git
cd our-claude-skills/custom-skills/_ourdigital-shared
./install.sh

# Credentials need to be set up separately (security)
# Either use 1Password CLI or manually copy ~/.env.ourdigital

Troubleshooting

Permission denied

chmod +x install.sh

Python version

# Check version (need 3.11+)
python3 --version

# Use pyenv if needed
pyenv install 3.11
pyenv local 3.11

Missing credentials

# Check what's missing
python scripts/validate_install.py --verbose

File Reference

File Purpose
install.sh Main installer script
.env.ourdigital.template Environment template
config/ourdigital.yaml Default configuration
requirements/base.txt Common dependencies
requirements/code.txt Claude Code dependencies
scripts/validate_install.py Installation validator