Global Skills Template

Universal AI skills for Claude, Codex, Cursor, and ChatGPT.

Quick Install

# From any project directory
cd {project}
install-global-skills

What gets set up automatically:

• ✅ 26 global skills installed (20 domain + 6 meta)
• ✅ Codex/Cursor formats converted
• ✅ Cursor rule added to project
• ✅ VS Code settings added to project
• ✅ Claude Code CLI config created (global)
• ✅ Codex CLI config created (global)
• 📋 Instructions for UI platforms (Codex UI, Claude UI, ChatGPT)

Installation Methods

Option 1: npm/pnpm Package (Recommended)

# Install globally
pnpm add -g @cpretzinger/global-skills

# Run installer (from project directory)
cd {project}
install-global-skills

Option 2: Bash Script

# Run setup script
bash ~/projects/global-skills-template/scripts/setup-global-skills.sh

Option 3: Direct Node Script

cd {project}
node ~/projects/global-skills-template/lib/setup.js

What Gets Installed

Global Skills (26 total)

20 Domain Skills:

• postgres, react-patterns, api-design, debugging, error-handling
• code-review, git-mastery, performance, security, testing-strategy
• typescript-advanced, data-modeling, refactoring, caching-strategies
• qdrant, vercel-railway, openai-api, prompt-engineering
• illustration-creator, video-creation

6 Meta Skills:

• critical-thinking (consolidates 12+ meta-skills)
• analogical-reasoning, skill-composition, social-modeling
• tool-discovery, tool-creation

Auto-Setup (When run from project directory)

• Cursor: Auto-load rule added to .cursor/rules/
• VS Code: Settings added to .vscode/settings.json
• Claude Code CLI: Config created at ~/.claude-code/config.json
• Codex CLI: Config created at ~/.codex/config.json

Manual Setup Required

• Codex UI: Copy system prompt from auto-load-configs/codex-ui-system-prompt.md
• Claude UI: Copy system prompt from auto-load-configs/claude-ui-system-prompt.md
• ChatGPT Main UI: Upload to Google Drive + system prompt (see GOOGLE_DRIVE_SETUP.md)

Platform Access

Auto-Discovery

• Codex: ~/.codex/skills/ ✅
• Cursor: ~/.cursor/skills-cursor/ ✅

Manual Loading

• Claude Code: Create project MASTER_INDEX.md referencing ~/.claude-docs/GLOBAL_SKILLS_INDEX.md
• Claude Chat: Paste "Load global skills from ~/.claude-docs/GLOBAL_SKILLS_INDEX.md"
• ChatGPT Main UI: Upload 00_CANON_GLOBAL_SKILLS__MUST_LOAD.md to Google Drive + add system prompt

Documentation

• INSTALL.md - Detailed installation instructions
• QUICK_START.md - Quick reference guide
• AUTO_LOAD_SETUP.md - Complete auto-load setup for all platforms
• CHANGELOG.md - Version history and changes
• IC2_REPO_CLEANUP_PROMPT.md - Instructions for cleaning up IC2 repo

Project Structure

global-skills-template/
├── README.md                    # This file
├── INSTALL.md                   # Detailed install guide
├── QUICK_START.md               # Quick reference
├── AUTO_LOAD_SETUP.md          # Auto-load setup guide
├── CHANGELOG.md                 # Version history
├── package.json                 # npm package config
├── bin/
│   └── install-global-skills    # Installer entry point
├── lib/
│   ├── setup.js                 # Main installer script
│   ├── convert-formats.js       # Format conversion
│   └── validate.js              # Validation script
├── scripts/
│   └── setup-global-skills.sh   # Bash installer
├── templates/                   # Skill templates
│   ├── GLOBAL_SKILLS_INDEX.md
│   ├── skills/                  # 20 domain skills
│   └── meta/                    # 6 meta skills
└── auto-load-configs/           # Platform configs
    ├── README.md
    ├── cursor-rule.mdc
    ├── vscode-settings.json
    ├── claude-code-cli-config.json
    ├── codex-cli-config.json
    ├── codex-ui-system-prompt.md
    ├── claude-ui-system-prompt.md
    ├── chatgpt-main-ui-system-prompt-ULTRA.md
    └── chatgpt-main-ui-instructions.md

Troubleshooting

Command Not Found

If install-global-skills isn't found:

# Run directly
cd {project}
node ~/projects/global-skills-template/lib/setup.js

# Or use bash script
bash ~/projects/global-skills-template/scripts/setup-global-skills.sh

Skills Not Loading

1. Verify installation:

   ls ~/.claude-docs/skills/ | wc -l  # Should show 20
   ls ~/.claude-docs/meta/ | wc -l    # Should show 6

2. Restart the application (Cursor, VS Code, etc.)

3. Check config files are in correct locations

Adding New Skills

If you add new skills to the templates/skills/ or templates/meta/ directories:

1. Add the skill file to templates/skills/ or templates/meta/
2. Update GLOBAL_SKILLS_INDEX.md in templates/ to include the new skill
3. Run install script to update installations:

   install-global-skills

The script will:

• Copy new skills to ~/.claude-docs/skills/ or ~/.claude-docs/meta/
• Convert to Codex format (~/.codex/skills/)
• Convert to Cursor format if it's a meta skill (~/.cursor/skills-cursor/)
• Update the GLOBAL_SKILLS_INDEX.md

Note: Existing installations will get the new skills on next run of install-global-skills.

License

MIT