{"id":"11fc9631-3d71-4daf-ae7d-6b015e82de44","shortId":"WgzTBm","kind":"skill","title":"jup","tagline":"jup is a command-line tool for installing and managing agent skills across different ai agents, scopes, and projects.","description":"# jup: Agent Skills Manager ✨\n\n`jup` is a lightweight Python-based command-line tool designed to manage and synchronize \"agent skills\" across various AI assistant directories (e.g., Gemini, Copilot, Claude). It allows users to install skills from GitHub repositories or local directories, keeping them organized via a lockfile and syncing them to target locations using symlinks or file copies.\n\n## Core Concepts\n\n- **Skills**: A directory containing a `SKILL.md` file.\n- **Syncing**: Linking or copying skills from your local cache (`~/.jup/skills/`) to agent-specific directories (e.g., `~/.gemini/skills/`).\n- **Lockfile**: A central record of all installed skill sources and their metadata.\n\n## Usage Instructions\n\n### Adding Skills\nYou can add skills from GitHub repositories, URLs, or local paths.\n\n- **GitHub Repository**: `jup add owner/repo`\n- **GitHub URL**: `jup add https://github.com/owner/repo/tree/branch/path`\n- **Versioning**: `jup add owner/repo@v1.0.0` (Supports tags, SHAs, or branches).\n- **Exact Path**: `jup add owner/repo/path/to/skill` (Faster installation for large repos).\n- **Targeting**:\n  - `--agent (-a) name`: Install to specific agent(s).\n  - `--scope user|local`: Set target scope.\n  - `--dir path`: Install to a custom directory (overrides agent/scope).\n- **Options**:\n  - `--category (-c) name`: Category (default: `misc`).\n  - `--skills name1,name2`: Select specific skills from a collection.\n\n### Listing Skills\nCheck the status of your skills with flexible aliases:\n- `jup list` or `jup ls`: Shows installed skills, versions, and origins.\n- `jup ls skills`: Alias for `jup list`.\n- `jup ls agents` or `jup ls agent`: Lists configured harness providers.\n- `jup ls config`: Shows current configuration.\n- `jup list --json`: Outputs status in clean, machine-readable format.\n\n### Syncing\nPush your managed skills to agents:\n- `jup sync`: Updates all links/copies in configured agent directories.\n- `jup sync --update` (or `jup up`): Checks GitHub for updates.\n\n### Searching Registry\n- `jup find query`: Search the `skills.sh` registry.\n- `jup find query -it`: Interactive mode to preview and install skills.\n\n### Configuration\nManage your environment:\n- `jup config show`: View current settings (renamed `global` scope to `user`).\n- `jup config set sync-mode copy`: Switch from symlinks to file copies.\n\n## Agent Specifics\n`jup` supports built-in paths for:\n- `gemini`: `~/.gemini/skills`\n- `copilot`: `~/.copilot/skills`\n- `claude`: `~/.claude/skills`\n- `cursor`: `~/.cursor/skills`\n- `codex`: `~/.codex/skills`\n- `antigravity`: `~/.gemini/antigravity/skills`\n- `default`: `~/.agents/skills`\n\nYou can add custom agents with `jup agent add`.","tags":["jup","andrader","agent","agent-skills","agentic-ai","agents","ai-agents","cli","installer","manager","skills"],"capabilities":["skill","source-andrader","skill-jup","topic-agent","topic-agent-skills","topic-agentic-ai","topic-agents","topic-ai-agents","topic-cli","topic-installer","topic-manager","topic-skills"],"categories":["jup"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/andrader/jup/jup","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add andrader/jup","source_repo":"https://github.com/andrader/jup","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 10 github stars · SKILL.md body (2,678 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T07:03:32.726Z","embedding":null,"createdAt":"2026-04-23T13:04:10.870Z","updatedAt":"2026-04-24T07:03:32.726Z","lastSeenAt":"2026-04-24T07:03:32.726Z","tsv":"'/.agents/skills':360 '/.claude/skills':352 '/.codex/skills':356 '/.copilot/skills':350 '/.cursor/skills':354 '/.gemini/antigravity/skills':358 '/.gemini/skills':107,348 '/.jup/skills':100 '/owner/repo/tree/branch/path':146 'across':15,44 'ad':122 'add':126,138,143,149,160,363,369 'agent':13,18,23,42,103,168,174,238,242,270,278,338,365,368 'agent-specif':102 'agent/scope':190 'ai':17,46 'alia':232 'alias':217 'allow':54 'antigrav':357 'assist':47 'base':32 'branch':156 'built':343 'built-in':342 'c':193 'cach':99 'categori':192,195 'central':110 'check':209,286 'claud':52,351 'clean':259 'codex':355 'collect':206 'command':6,34 'command-lin':5,33 'concept':83 'config':249,315,326 'configur':244,252,277,310 'contain':87 'copi':81,94,331,337 'copilot':51,349 'core':82 'current':251,318 'cursor':353 'custom':187,364 'default':196,359 'design':37 'differ':16 'dir':182 'directori':48,64,86,105,188,279 'e.g':49,106 'environ':313 'exact':157 'faster':162 'file':80,90,336 'find':293,300 'flexibl':216 'format':263 'gemini':50,347 'github':60,129,135,140,287 'github.com':145 'github.com/owner/repo/tree/branch/path':144 'global':321 'har':245 'instal':10,57,114,163,171,184,224,308 'instruct':121 'interact':303 'json':255 'jup':1,2,22,26,137,142,148,159,218,221,229,234,236,240,247,253,271,280,284,292,299,314,325,340,367 'keep':65 'larg':165 'lightweight':29 'line':7,35 'link':92 'links/copies':275 'list':207,219,235,243,254 'local':63,98,133,178 'locat':76 'lockfil':70,108 'ls':222,230,237,241,248 'machin':261 'machine-read':260 'manag':12,25,39,267,311 'metadata':119 'misc':197 'mode':304,330 'name':170,194 'name1':199 'name2':200 'option':191 'organ':67 'origin':228 'output':256 'overrid':189 'owner/repo':139,150 'owner/repo/path/to/skill':161 'path':134,158,183,345 'preview':306 'project':21 'provid':246 'push':265 'python':31 'python-bas':30 'queri':294,301 'readabl':262 'record':111 'registri':291,298 'renam':320 'repo':166 'repositori':61,130,136 'scope':19,176,181,322 'search':290,295 'select':201 'set':179,319,327 'shas':154 'show':223,250,316 'skill':14,24,43,58,84,95,115,123,127,198,203,208,214,225,231,268,309 'skill-jup' 'skill.md':89 'skills.sh':297 'sourc':116 'source-andrader' 'specif':104,173,202,339 'status':211,257 'support':152,341 'switch':332 'symlink':78,334 'sync':72,91,264,272,281,329 'sync-mod':328 'synchron':41 'tag':153 'target':75,167,180 'tool':8,36 'topic-agent' 'topic-agent-skills' 'topic-agentic-ai' 'topic-agents' 'topic-ai-agents' 'topic-cli' 'topic-installer' 'topic-manager' 'topic-skills' 'updat':273,282,289 'url':131,141 'usag':120 'use':77 'user':55,177,324 'v1.0.0':151 'various':45 'version':147,226 'via':68 'view':317","prices":[{"id":"d635c4cf-856e-4821-a979-3715141a2926","listingId":"11fc9631-3d71-4daf-ae7d-6b015e82de44","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"andrader","category":"jup","install_from":"skills.sh"},"createdAt":"2026-04-23T13:04:10.870Z"}],"sources":[{"listingId":"11fc9631-3d71-4daf-ae7d-6b015e82de44","source":"github","sourceId":"andrader/jup/jup","sourceUrl":"https://github.com/andrader/jup/tree/main/skills/jup","isPrimary":false,"firstSeenAt":"2026-04-23T13:04:10.870Z","lastSeenAt":"2026-04-24T07:03:32.726Z"}],"details":{"listingId":"11fc9631-3d71-4daf-ae7d-6b015e82de44","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"andrader","slug":"jup","github":{"repo":"andrader/jup","stars":10,"topics":["agent","agent-skills","agentic-ai","agents","ai","ai-agents","cli","installer","manager","skills"],"license":null,"html_url":"https://github.com/andrader/jup","pushed_at":"2026-04-24T03:07:45Z","description":"jup is a command-line tool for installing and managing agent skills across different ai agents, scopes, and projects.","skill_md_sha":"10e967cffb72ffc3a97783cc289f88f7d1506fd3","skill_md_path":"skills/jup/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/andrader/jup/tree/main/skills/jup"},"layout":"multi","source":"github","category":"jup","frontmatter":{},"skills_sh_url":"https://skills.sh/andrader/jup/jup"},"updatedAt":"2026-04-24T07:03:32.726Z"}}