wondelai/skills

Purpose and Entry Points

This is a Markdown-first distribution repository for 50 expert-framework agent skills and 12 orchestration metaskills. It targets Claude-family agents, Codex, Cursor, Windsurf, Pi, and agentskills.io-compatible tooling; it is not a runtime application or web service. Canonical user-facing entry points are individual SKILL.md files, plugin marketplaces, and npx skills installation. Key paths: README.md, jobs-to-be-done/SKILL.md, .claude-plugin/marketplace.json.

Canonical Skill Content

Each top-level skill directory is a self-contained knowledge module: an instruction contract in SKILL.md plus supporting reference documents. Agents load the skill to apply a named product, business, UX, or engineering framework. This is the source content that all distribution forms expose. Examples: clean-architecture/SKILL.md, clean-architecture/references/dependency-rule.md, cro-methodology/SKILL.md.

Metaskill Orchestration Layer

Twelve metaskills compose multiple individual skills into ordered, interactive journeys for creating, improving, or growing businesses, websites, apps, and codebases. They persist progress and generated decision artifacts in the consuming project’s docs/ directory, allowing session resumption. Artifact conventions are documented in docs/ARTIFACT-REGISTRY.md; metaskill entry modules include create-app/SKILL.md, improve-code-quality/SKILL.md, and design-code-architecture/SKILL.md.

Plugin Collection Boundary

Skills are packaged into curated domain collections for plugin consumers. Plugin manifests define the installable collections; collection directories expose selected skills rather than redefining their contents. The primary manifest source is .claude-plugin/marketplace.json, with Codex plugin outputs under plugins/*/.codex-plugin/plugin.json, e.g. plugins/systems-architecture/.codex-plugin/plugin.json and plugins/metaskills/.codex-plugin/plugin.json.

Cross-Agent Distribution Mirrors

The repository maintains platform-specific skill trees for agent discovery. These are deployment/distribution representations of the canonical top-level skills, including Claude, Codex, Cursor, Pi, and Windsurf targets. Important boundaries are .claude/skills/, .agents/skills/, .cursor/skills/, .pi/skills/, and .windsurf/skills/; consumers should treat top-level skill directories as the authoring source unless synchronization rules state otherwise.

Generation and Synchronization Flow

Maintenance scripts transform canonical marketplace and skill content into consumer-facing artifacts. scripts/generate-codex-plugins.sh generates Codex plugin definitions from the Claude marketplace source; scripts/sync-ide-skills.sh synchronizes cross-IDE skill mirrors; scripts/sync-marketplace-versions.sh updates marketplace version metadata. GitHub Actions automates marketplace-version synchronization via .github/workflows/sync-marketplace-version.yml.

Runtime, Infrastructure, and External Dependencies

No application server, database, or deployed runtime appears in the repository. Execution happens inside installed AI coding-agent runtimes and through Node-based npx skills installation. External integration points are the Claude/Codex plugin systems, agentskills.io-compatible clients, skills.sh, GitHub Actions, and the public catalog at https://skills.wondel.ai/.