canonical-skills

Bootstrap local tools and sync Pear's canonical skill library across Codex and Claude Desktop targets.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill canonical-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: canonical-skills
Source: https://github.com/Pear-Commerce/pear-ai-skills/tree/main/skills/canonical-skills
Command: npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill canonical-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the friction of manually setting up and managing Pear's AI assistant skills across Codex-compatible and Claude Desktop clients, ensuring you always have access to the latest canonical skill library without inconsistent local copies.

Core Features & Use Cases

  • Automatic Tool Bootstrapping: Installs missing required tools like Git, GitHub CLI, and Homebrew on macOS when needed for skill management workflows.
  • On-Demand Skill Syncing: Pulls the latest Pear canonical skill repository and syncs all available skills to your local assistant targets automatically.
  • Enforced Skill Editing Workflow: Ensures all skill creation and edits are made in the canonical source repository first, then synced to local mirrors to avoid divergent copies.
  • Use Case: If you ask your AI assistant to use a Pear skill like check-partner-upc but don't have the skill library installed, this Skill automatically sets up required tools, pulls the canonical repo, and syncs all skills so the requested workflow is ready to use.

Quick Start

Ask your AI assistant to use the canonical-skills skill to automatically bootstrap required tools and sync all available Pear skills to your local assistant.

Frequently Asked Questions about canonical-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Pear's canonical AI assistant skill library to my local machine?

Tool bootstrapping automatically installs missing required dependencies like Git, GitHub CLI, and Homebrew on macOS, ensuring your local environment is ready for AI assistant skill management workflows before syncing begins.

How do I create and edit Pear skills without causing divergent copies?

To edit Pear skills properly, the enforced editing workflow requires making all changes in the canonical source repository first, which then syncs to local mirrors to prevent divergent copies across assistant targets.

Does this skill synchronization tool work with both Claude Desktop and Codex-compatible targets?

Yes, cross-target skill mirror distribution works by synchronizing the canonical skill repository across both Codex-compatible and Claude Desktop clients, ensuring consistent skill availability on each platform.

Why does my AI assistant fail to use a Pear skill like check-partner-upc?

Your AI assistant fails because the skill library is not installed locally; this tool resolves the issue by automatically bootstrapping required tools, pulling the canonical repo, and syncing the requested workflow.