oh-my-customcode 0.14.0 → 0.15.0

package/README.md

@@ -21,7 +21,7 @@ Like oh-my-zsh transformed shell customization, oh-my-customcode makes personali
 
 | Feature | Description |
 |---------|-------------|
-| **Batteries Included** | 42 agents, 52 skills, 22 guides, 18 rules, 1 hook, 4 contexts, ontology graph - ready to use out of the box |
+| **Batteries Included** | 42 agents, 53 skills, 22 guides, 18 rules, 1 hook, 4 contexts, ontology graph - ready to use out of the box |
 | **Sub-Agent Model** | Supports hierarchical agent orchestration with specialized roles |
 | **Dead Simple Customization** | Create a folder + markdown file = new agent or skill |
 | **Mix and Match** | Use built-in components, create your own, or combine both |
@@ -125,7 +125,7 @@ Claude Code selects the appropriate model and parallelizes independent tasks (up
 | **QA** | 3 | qa-planner, qa-writer, qa-engineer |
 | **Total** | **42** | |
 
-### Skills (52)
+### Skills (53)
 
 | Category | Count | Skills |
 |----------|-------|--------|
@@ -139,6 +139,7 @@ Claude Code selects the appropriate model and parallelizes independent tasks (up
 | **Operations** | 7 | update-docs, update-external, audit-agents, fix-refs, sauron-watch, monitoring-setup, claude-code-bible |
 | **Utilities** | 5 | lists, help, status, result-aggregation, writing-clearly-and-concisely |
 | **Deploy** | 2 | vercel-deploy, codex-exec |
+| **External** | 1 | skills-sh-search |
 
 ### Guides (22)
 
@@ -224,7 +225,7 @@ your-project/
     │   ├── be-fastapi-expert.md
     │   ├── mgr-creator.md
     │   └── ...
-    ├── skills/            # Skill modules (52 directories, each with SKILL.md)
+    ├── skills/            # Skill modules (53 directories, each with SKILL.md)
     │   ├── go-best-practices/
     │   ├── react-best-practices/
     │   ├── secretary-routing/

package/dist/cli/index.js

@@ -14125,7 +14125,7 @@ async function generateMCPConfig(targetDir) {
   }
   try {
     execSync3("uv venv .venv", { cwd: targetDir, stdio: "pipe" });
-    execSync3("uv pip install ontology-rag", { cwd: targetDir, stdio: "pipe" });
+    execSync3('uv pip install "ontology-rag @ git+https://github.com/baekenough/oh-my-customcode.git#subdirectory=packages/ontology-rag"', { cwd: targetDir, stdio: "pipe" });
   } catch (error2) {
     const msg = error2 instanceof Error ? error2.message : String(error2);
     throw new Error(`Failed to setup Python environment: ${msg}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-customcode",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/ontology/skills.yaml

@@ -65,6 +65,10 @@ classes:
     skills: [monitoring-setup]
     description: "Monitoring configuration"
 
+  ExternalSkillSourceSkill:
+    skills: [skills-sh-search]
+    description: "External skill marketplace discovery and installation"
+
 # Skill instances
 skills:
   airflow-best-practices:
@@ -419,6 +423,15 @@ skills:
     keywords: [rust, ownership, borrowing, safety, concurrency]
     rule_references: []
 
+  skills-sh-search:
+    class: ExternalSkillSourceSkill
+    description: "Search and install skills from skills.sh marketplace when internal skills are insufficient"
+    user_invocable: true
+    model_invocable: true
+    summary: "Search skills.sh marketplace for external skills and install them into the project"
+    keywords: [skills-sh, marketplace, external, install, search, discover, npx]
+    rule_references: [R003, R006]
+
   sauron-watch:
     class: VerificationSkill
     description: "Full R017 verification (5+3 rounds) before commit"

package/templates/.claude/skills/skills-sh-search/SKILL.md

@@ -0,0 +1,160 @@
+---
+name: skills-sh-search
+description: Search and install skills from skills.sh marketplace when internal skills are insufficient
+argument-hint: "<query> [--install] [--global]"
+---
+
+# Skills.sh Search Skill
+
+Search the [skills.sh](https://skills.sh/) marketplace for reusable AI agent skills when no matching internal skill exists. Install discovered skills directly into the project.
+
+## Prerequisites
+
+- Node.js and npx available in PATH
+- Network access to skills.sh registry
+
+## Options
+
+```
+<query>          Required. Search query describing the capability needed
+--install, -i    Install selected skill after search
+--global, -g     Install to ~/.claude/skills/ instead of project .claude/skills/
+--list, -l       List currently installed skills.sh skills
+--check, -c      Check for updates on installed skills.sh skills
+```
+
+## Workflow
+
+```
+1. Search skills.sh marketplace
+   ├── Run: npx --yes skills find "<query>"
+   ├── Review results (name, description, install count)
+   └── Present top candidates to user
+
+2. User selects skill
+   ├── Confirm selection with user
+   └── Check for namespace conflicts with existing skills
+
+3. Install skill
+   ├── Run: npx --yes skills add <source> [-g]
+   ├── Verify installation in .claude/skills/
+   └── Check installed SKILL.md frontmatter
+
+4. Post-install adaptation
+   ├── Review installed SKILL.md frontmatter
+   ├── Add oh-my-customcode fields if missing:
+   │   ├── user-invocable: true|false
+   │   ├── model-invocable (if not present)
+   │   └── argument-hint (if applicable)
+   └── Add source metadata:
+       ├── source-type: skills-sh
+       └── source-origin: <owner/repo>
+
+5. Ontology sync
+   ├── Notify: run "omcustom ontology build" to register new skill
+   └── Or manually add to skills.yaml if ontology CLI unavailable
+```
+
+## Namespace Conflict Check
+
+Before installing, verify no existing skill shares the same name:
+
+```bash
+# Check for conflict
+ls .claude/skills/ | grep -w "<skill-name>"
+```
+
+If conflict exists:
+- Warn user about the conflict
+- Suggest renaming or skipping
+- Never overwrite existing skills without explicit approval
+
+## Output Format
+
+### Search Results
+```
+[skills-sh-search] Searching marketplace...
+
+Query: "<query>"
+Results: 5 found
+
+  1. owner/skill-name (12.3K installs)
+     Description of the skill
+
+  2. owner/another-skill (8.1K installs)
+     Description of the skill
+
+  3. owner/third-skill (3.5K installs)
+     Description of the skill
+
+Select [1-3] or "skip" to cancel:
+```
+
+### Install Success
+```
+[skills-sh-search] Installed
+
+Skill: <skill-name>
+Source: <owner/repo>
+Location: .claude/skills/<skill-name>/SKILL.md
+Adapted: ✓ (added user-invocable, source metadata)
+
+Next: Run "omcustom ontology build" to register in ontology.
+```
+
+### Install Failure
+```
+[skills-sh-search] Failed
+
+Error: <error_message>
+Suggested Fix: <suggestion>
+```
+
+### No Results
+```
+[skills-sh-search] No Results
+
+Query: "<query>"
+Suggestions:
+  - Try broader search terms
+  - Check https://skills.sh/ directly
+  - Consider creating a custom skill with /create-agent
+```
+
+## Examples
+
+```bash
+# Search for Terraform skills
+/skills-sh-search terraform infrastructure
+
+# Search and install
+/skills-sh-search "react testing patterns" --install
+
+# Install globally
+/skills-sh-search "git workflow" --install --global
+
+# List installed skills.sh skills
+/skills-sh-search --list
+
+# Check for updates
+/skills-sh-search --check
+```
+
+## Integration
+
+### With intent-detection
+When intent-detection finds no matching agent and the domain is identifiable, this skill can be suggested as a fallback to find relevant external skills.
+
+### With update-external
+Installed skills.sh skills are tracked with `source-type: skills-sh` metadata, enabling `update-external` to check for updates via `npx skills check`.
+
+### With create-agent
+If a skills.sh skill provides domain knowledge, `create-agent` can reference it when building a new agent for that domain.
+
+## Safety
+
+- **Read-only by default**: Search does not modify anything
+- **Explicit install**: Installation requires `--install` flag or user confirmation
+- **No auto-execution**: Installed skills are not auto-invoked without ontology registration
+- **Conflict protection**: Never overwrites existing skills
+- **Telemetry opt-out**: Set `DISABLE_TELEMETRY=1` to disable skills CLI telemetry

package/templates/.claude/skills/update-external/SKILL.md

@@ -37,6 +37,15 @@ web-design-guidelines:
   type: github
 ```
 
+### Skills (from skills.sh marketplace)
+```yaml
+<skill-name>:
+  source: <owner/repo>
+  type: skills-sh
+```
+
+Skills installed via `skills-sh-search` are tracked with `source-type: skills-sh` in their frontmatter. Update checks use `npx skills check`.
+
 ### Guides (reference documentation)
 ```yaml
 golang:
@@ -58,6 +67,7 @@ python:
 
 2. Check for updates
    ├── GitHub: Check releases/commits
+   ├── skills-sh: Run "npx skills check"
    ├── Documentation: Check last-modified
    └── Compare with current version
 
@@ -89,6 +99,14 @@ source:
       date: "2026-01-20"
     - version: "1.2.0"
       date: "2026-01-22"
+
+# skills.sh source
+source:
+  type: external
+  origin: skills-sh
+  registry: https://skills.sh
+  installed_via: "npx skills add <owner/repo>"
+  last_checked: "2026-02-20"
 ```
 
 ## Output Format

package/templates/manifest.json

@@ -18,7 +18,7 @@
       "name": "skills",
       "path": ".claude/skills",
       "description": "Reusable skill modules (includes slash commands)",
-      "files": 52
+      "files": 53
     },
     {
       "name": "guides",