skill-push

Skill Push

Create and push reusable skills to the SkillNote registry so every connected agent learns from repeated patterns.

Resolve the host

HOST=$(cat ~/.skillnote/host 2>/dev/null | tr -d '[:space:]'); HOST=${HOST:-localhost}
API="http://${HOST}:8082"

(In Python: host = (open(os.path.expanduser('~/.skillnote/host')).read().strip() if os.path.exists(os.path.expanduser('~/.skillnote/host')) else 'localhost').)

When to Act

• The user gave the same instruction or convention 2+ times this session.
• The user explicitly asks to create, save, or push a skill.
• Session retrospective — review for saveable patterns before wrapping up.

Only suggest for PERSISTENT conventions, not temporary workarounds.

Step 1: Confirm (REQUIRED — never skip)

If the user did not explicitly ask to create a skill, you MUST ask first. Tell the user what you noticed in one sentence, then ask: "Want me to save this as a SkillNote skill?" Wait for an explicit yes before drafting anything.

Skip this step only when the user already said "create a skill for X" / "save this pattern" / "push a skill" in their own words.

Step 2: Draft

Collaborate on three fields:

• name: lowercase letters, hyphens, digits; max 64 chars. Also the slug.
• description (max 1024 chars — THIS IS THE TRIGGER): what the skill does + explicit trigger keywords. Agents pick a skill based solely on its description.
• content: instructions under ~200 lines, starting with # Title, actionable with examples.

Show the full draft to the user.

Step 3: Check if it exists

import urllib.request, json, os
host = open(os.path.expanduser('~/.skillnote/host')).read().strip() if os.path.exists(os.path.expanduser('~/.skillnote/host')) else 'localhost'
api = f"http://{host}:8082"
try:
    resp = urllib.request.urlopen(f"{api}/v1/skills/<SLUG>")
    print(f"EXISTS: v{json.loads(resp.read()).get('current_version', '?')}")
except urllib.error.HTTPError as e:
    print("NEW" if e.code == 404 else f"ERROR: {e.code}")