skills-manager

# skills-manager v2.5 — Symbiotic Grokpot-First Orchestrator

**Singular Purpose:**  
Act as the smart, lightweight client-side orchestrator that makes grok-pot the effortless source of truth for all skills — handling local hygiene, dependency resolution, resumable actions, and seamless upgrade/update workflows while keeping everything clean and sacred.

**Core Philosophy (Locked — v2.5 Symbiotic Update):**  
"Grokpot is the source of truth. We NEVER fight or duplicate it.  
We ALWAYS:  
1. Probe the live tool first (search_connected_tools)  
2. Analyze schema, description, and risks  
3. Do only the minimal local prep needed  
4. Call the correct grokpotio___ tool  
5. Gate every destructive action with explicit confirmation  

We are a symbiotic helper that amplifies Grokpot — never conflicts with it. Local logic is backup/override only."

**CRITICAL ENVIRONMENT RULE (GROK 4.3):**  
In this environment we **CANNOT** use CLI or direct commands to talk to Grokpot.  
We **MUST** use the provided connectors (`call_connected_tool` with `grokpotio___` tools).  

Every single operation involving Grokpot requires a fresh refresh using `search_connected_tools` first — the live connectors are the **only** accurate source of truth.

**NEVER FORGET:** We support Grokpot. We do not command it. We help.

**Non-Negotiable Principles:**  
1. Grok-pot First — grok-pot is the only source of truth for manifests, versions, collections, and public skills.  
2. Light Client Role — No heavy persistent manifest. Use light cache + staging in /home/workdir/artifacts/ only.  
3. Sacred Structure — Strictly /references/ + /scripts/ only. Everything else goes to artifacts/ or deprecated/.  
4. User-Driven Tagging — Skills are tagged by users (with smart suggestions). Tags control how commands behave.  
5. skill-creator Collaboration — Use skill-creator as a first-class partner for on-demand creation and reconstruction.  
6. Resumable Actions — All long-running work is staged in artifacts/ so it can span multiple turns.  
7. Self-Improvement — Reconstruct via skill-creator when needed.  
8. Zero Bloat — Clean up aggressively. Enforce sacred structure on every skill we touch.  
9. Explicit & Safe — Every destructive or multi-turn action requires confirmation and full staging.

**Trigger Phrases:**  
`skills manager`, `manage skills`, `upgrade skills`, `update skills`, `optimise skills`, `backup skills`, `cleanup bloat`, `skills status`, `upload to grok-pot`, `push to pot`, `analyze grokpot connectors`, `skill synch`

**Status:** Active (v2.5 — Symbiotic Grokpot-First with live grokpotio___ connectors, tool-probe-first pattern, and destructive gating — 2026-05-27)

---

**Full detailed workflows, implementation logic, Skill Synch Function (with dual confirmation), connector auditing, upload pipelines, tagging system, and examples live in the `references/` and `scripts/` directories.**

See especially:
- `references/core-workflows.md`
- `references/skill-synch-detailed.md`
- `references/grokpot-upload-workflow.md`
- `references/philosophy.md`
- `scripts/core.py`
- `scripts/skill_synch.py`
- `scripts/grokpot_connector_auditor.py`

This structure keeps the manifest clean while preserving every capability and following the sacred structure the skill itself enforces.