{"id":"7af06844-7a1c-45dc-bd8c-46e598beff69","shortId":"sTw52c","kind":"skill","title":"Skills Cli","tagline":"Skills skill by Xixu Me","description":"Use this skill to help users work with the open Agent Skills ecosystem through the `skills` CLI.\n\n## Overview\n\nThe `skills` CLI is the package manager for installable Agent Skills. Use it to discover skills, install them with the right flags, and manage them after installation.\n\nExamples below use `bunx skills`, but `npx skills` is the same workflow if Bun is not available in the user's environment.\n\nAlways prefer the current CLI syntax:\n\n```bash\nbunx skills add <source> --skill <name>\n```\n\nDo not use older `owner/repo@skill-name` examples.\n\n## When to Use\n\nUse this skill when the user:\n\n- asks \"find a skill for X\", \"is there a skill for X\", or \"how do I do X\" and X sounds like a reusable workflow\n- asks \"can you do X\" and X sounds like a specialized capability that may already exist as a skill\n- wants help with `bunx skills`, `npx skills`, `skills.sh`, skill package installation, or `skills-lock.json`\n- wants to install a skill for a specific agent such as Codex or OpenCode\n- wants to list, check, update, remove, restore, sync, back up, or initialize installed skills\n- wants help searching for workflows, tools, templates, or domain-specific capabilities such as design, testing, deployment, documentation, or code review\n\nDo not use this skill when the user already has a local skill and wants help writing or improving its contents. In that case, use a skill-authoring workflow instead.\n\n## Discovery Workflow\n\nWhen a user needs a skill, follow this sequence:\n\n1. Identify the domain and task.\n   Examples: React performance, PR review, changelog generation, PDF extraction.\n   Also judge whether the task is common enough that a reusable skill is likely to exist.\n2. Check [skills.sh](https://skills.sh/) first.\n   Prefer well-known, well-installed skills when the domain is already covered there.\n3. If the leaderboard does not clearly answer the need, search with:\n\n```bash\nbunx skills find <query>\n```\n\n1. Verify quality before recommending anything:\n   - install count: prefer skills with 1K+ installs and be cautious with anything under 100\n   - source reputation: prefer official or well-established maintainers such as `openai`, `anthropics`, `microsoft`, or similarly trusted publishers\n   - repository quality: check the source repository and treat skills from repos with fewer than 100 stars skeptically\n2. Present the options clearly.\n   Include the skill name, what it helps with, the install count and source, why it looks trustworthy, the install command, and a link to learn more on `skills.sh`.\n3. Offer installation help if the user wants to proceed.\n4. If nothing fits, say so directly, help with the task using your general capabilities, and mention that the user can create their own package with `bunx skills init`.\n\n## Installation Quick Reference\n\n### Common sources\n\n```bash\n# GitHub shorthand\nbunx skills add xixu-me/skills\n\n# Full GitHub URL\nbunx skills add https://github.com/xixu-me/skills\n\n# Direct path to one skill inside a repo\nbunx skills add https://github.com/xixu-me/skills/tree/main/skills/skills-cli\n\n# GitLab URL\nbunx skills add https://gitlab.com/org/repo\n\n# Any git URL\nbunx skills add git@github.com:owner/repo.git\n\n# Local package path\nbunx skills add ./my-local-skills\n```\n\n### Common install patterns\n\n```bash\n# List skills in a package without installing\nbunx skills add <source> --list\n\n# Install one skill\nbunx skills add <source> --skill skills-cli\n\n# Install multiple skills\nbunx skills add <source> --skill pr-review --skill commit\n\n# Install globally\nbunx skills add <source> --skill skills-cli -g -y\n\n# Install to a specific agent\nbunx skills add <source> --skill skills-cli -a codex -y\n\n# Install all skills to all agents\nbunx skills add <source> --all\n\n# Install all skills to one agent\nbunx skills add <source> --skill '*' -a codex -y\n\n# Copy files instead of symlinking\nbunx skills add <source> --skill skills-cli -a codex --copy -y\n```\n\n### Installation methods\n\nWhen the user is choosing how to install:\n\n- symlink is the default and usually the best choice because updates stay centralized\n- `--copy` creates independent copies and is the fallback when symlinks are unsupported or inconvenient\n\nIf the user only asks to install a skill, prefer the default symlink workflow unless they mention CI packaging, portability, filesystem restrictions, or explicitly ask for copies.\n\n### Important flags\n\n| Flag                  | Use                                            |\n| --------------------- | ---------------------------------------------- |\n| `--skill <name>`      | install one or more named skills               |\n| `-a, --agent <agent>` | target specific agents such as `codex`         |\n| `-g, --global`        | install at user scope instead of project scope |\n| `-y, --yes`           | skip prompts                                   |\n| `--list`              | list available skills in a package             |\n| `--copy`              | copy instead of symlink                        |\n| `--all`               | shorthand for all skills to all agents         |\n\n## Managing Installed Skills\n\nUse these commands for ongoing maintenance:\n\n```bash\n# List installed skills\nbunx skills ls\nbunx skills ls -g\nbunx skills ls -a codex\nbunx skills ls --json\n\n# Check for updates\nbunx skills check\n\n# Update installed skills\nbunx skills update\n\n# Remove installed skills\nbunx skills remove my-skill\nbunx skills remove my-skill -a codex\nbunx skills remove -g my-skill\nbunx skills remove --all\n\n# Initialize a new skill package\nbunx skills init\nbunx skills init my-skill\n\n# Restore from skills-lock.json\nbunx skills experimental_install\n\n# Sync node_modules skills into agent directories\nbunx skills experimental_sync\nbunx skills experimental_sync -a codex -y\n```\n\nWhen the user asks to initialize a skill, explain whether they want:\n\n- `bunx skills init` to create `SKILL.md` in the current directory\n- `bunx skills init <name>` to create a new subdirectory containing `SKILL.md`\n\n## Related Tool: Skills Vault\n\nIf the user wants declarative backup and restore of installed skills across machines or teams, use [Skills Vault](https://github.com/xixu-me/skills-vault).\n\nSkills Vault is a separate CLI companion for the `skills` ecosystem. It is not a `skills add` installable skill source. Use it when the user wants to snapshot installed skills into a manifest, preview restore commands, or reproduce the same setup elsewhere.\n\nCommon companion commands:\n\n```bash\n# Back up installed skills into skvlt.yaml\nbunx skvlt backup\n\n# Preview a restore\nbunx skvlt restore --dry-run\n\n# Restore everything from the manifest\nbunx skvlt restore --all\n\n# Diagnose the local environment\nbunx skvlt doctor\n```\n\nPrefer this tool over `skills experimental_*` when the user explicitly wants a portable manifest workflow, cross-machine backup and restore, or team-sharing of installed skill setups.\n\n## Recommendation Format\n\nWhen recommending a skill, keep the answer concrete and installable.\n\nUse a structure like this:\n\n```text\nI found a skill that should fit.\n\nSkill: <skill-name>\nWhy it matches: <one sentence>\nSource: <owner/repo or URL>\nQuality check: <install count / source reputation / repository confidence note>\nInstall:\nbunx skills add <source> --skill <skill-name> [optional flags]\nLearn more: https://skills.sh/<publisher>/<package>/<skill-name>\n\nIf you want, I can install it for <agent-or-scope>.\n```\n\nIf the user mentions a target agent or scope, include it in the command. Examples:\n\n```bash\nbunx skills add <source> --skill <skill-name> -a codex -y\nbunx skills add <source> --skill <skill-name> -g -y\n```\n\nExample:\n\n```text\nI found a skill that might help.\n\nSkill: screenshot\nWhy it matches: it focuses on OS-level desktop and window screenshot capture.\nSource: openai/skills\nQuality check: high install volume, trusted publisher, and a widely used source repository.\nInstall:\nbunx skills add openai/skills --skill screenshot\nLearn more: https://skills.sh/openai/skills/screenshot\n```\n\n## Common Skill Categories\n\nWhen the user's wording is vague, map it to likely categories:\n\n| Category        | Example queries                                    |\n| --------------- | -------------------------------------------------- |\n| Web Development | `react`, `nextjs`, `typescript`, `css`, `tailwind` |\n| Testing         | `testing`, `jest`, `playwright`, `e2e`             |\n| DevOps          | `deploy`, `docker`, `kubernetes`, `ci-cd`          |\n| Documentation   | `docs`, `readme`, `changelog`, `api-docs`          |\n| Code Quality    | `review`, `lint`, `refactor`, `best-practices`     |\n| Design          | `ui`, `ux`, `design-system`, `accessibility`       |\n| Productivity    | `workflow`, `automation`, `git`                    |\n\n## Search Tips\n\n- Use specific keywords. `react testing` is better than just `testing`.\n- Try alternative terms. If `deploy` fails, try `deployment` or `ci-cd`.\n- Check popular sources first. Many strong skills come from established publishers.\n- If the first search is too broad, narrow by domain plus task.\n\n## Common Mistakes\n\n- Recommending a skill from search results without checking whether it looks established.\n- Forgetting to specify `-a <agent>` when the user asked for one particular agent.\n- Treating `bunx skills find --help` like a real help command. Use `bunx skills --help` for command help instead.\n- Assuming no skill exists after one weak search term. Try a more specific or adjacent query first.\n\n## Troubleshooting\n\nIf the user hits an error or confusing result:\n\n- \"No skills found\" - suggest a better query, check [skills.sh](https://skills.sh/), or help directly and mention `bunx skills init`\n- interactive prompts in automation or CI - add `-y`\n- wrong installation scope - switch between project install and `-g`\n- symlink issues - retry with `--copy`\n- uncertainty about available package contents - run `bunx skills add <source> --list`\n- uncertainty about installed state - run `bunx skills ls` or `bunx skills ls --json`\n- portable backup or restore across machines - mention [Skills Vault](https://github.com/xixu-me/skills-vault) and its `backup` / `restore --dry-run` workflow\n\nWhen you are unsure about exact flags, use:\n\n```bash\nbunx skills --help\n```","tags":["skills","cli","xixu-me"],"capabilities":["skill","source-xixu-me","category-skills"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/xixu-me/skills/skills-cli","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under xixu-me/skills","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:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T02:40:12.236Z","embedding":null,"createdAt":"2026-04-18T20:23:41.965Z","updatedAt":"2026-04-24T02:40:12.236Z","lastSeenAt":"2026-04-24T02:40:12.236Z","tsv":"'/)':288 '/),':1328 '/my-local-skills':508 '/openai/skills/screenshot':1135 '/org/repo':493 '/skills':462 '/xixu-me/skills':471 '/xixu-me/skills-vault)':1393 '/xixu-me/skills-vault).':892 '/xixu-me/skills/tree/main/skills/skills-cli':485 '1':252,321 '100':340,373 '1k':332 '2':283,376 '3':305,409 '4':419 'access':1194 'across':883,1386 'add':84,458,468,482,490,499,507,522,529,539,550,564,580,590,602,909,1040,1073,1080,1127,1343,1367 'adjac':1304 'agent':18,35,169,561,577,587,687,690,727,823,1061,1271 'alreadi':143,218,302 'also':267 'altern':1212 'alway':75 'answer':312,1010 'anthrop':353 'anyth':326,338 'api':1178 'api-doc':1177 'ask':104,129,652,672,839,1267 'assum':1290 'author':238 'autom':1197,1340 'avail':69,710,1361 'back':183,939 'backup':877,947,991,1383,1396 'bash':81,317,453,512,737,938,1070,1410 'best':628,1186 'best-practic':1185 'better':1207,1322 'broad':1240 'bun':66 'bunx':56,82,151,318,445,456,466,480,488,497,505,520,527,537,548,562,578,588,600,741,744,748,753,760,766,772,778,786,793,802,805,814,825,829,848,858,945,951,962,970,1038,1071,1078,1125,1273,1283,1334,1365,1374,1378,1411 'capabl':140,200,433 'captur':1108 'case':233 'categori':1138,1150,1151 'category-skills' 'cautious':336 'cd':1172,1222 'central':633 'changelog':263,1176 'check':178,284,361,757,762,1036,1112,1223,1255,1324 'choic':629 'choos':617 'ci':665,1171,1221,1342 'ci-cd':1170,1220 'clear':311,380 'cli':2,24,28,79,533,554,568,606,898 'code':208,1180 'codex':172,570,593,608,693,752,785,834,1076 'come':1230 'command':400,733,928,937,1068,1281,1287 'commit':545 'common':273,451,509,935,1136,1246 'companion':899,936 'concret':1011 'confus':1315 'contain':866 'content':230,1363 'copi':595,609,634,637,674,715,716,1358 'count':328,391 'cover':303 'creat':440,635,852,862 'cross':989 'cross-machin':988 'css':1159 'current':78,856 'declar':876 'default':624,659 'deploy':205,1167,1215,1218 'design':203,1188,1192 'design-system':1191 'desktop':1104 'develop':1155 'devop':1166 'diagnos':966 'direct':425,472,1331 'directori':824,857 'discov':40 'discoveri':241 'doc':1174,1179 'docker':1168 'doctor':972 'document':206,1173 'domain':198,255,300,1243 'domain-specif':197 'dri':955,1399 'dry-run':954,1398 'e2e':1165 'ecosystem':20,903 'elsewher':934 'enough':274 'environ':74,969 'error':1313 'establish':348,1232,1259 'everyth':958 'exact':1407 'exampl':53,94,258,1069,1084,1152 'exist':144,282,1293 'experiment':816,827,831,978 'explain':844 'explicit':671,982 'extract':266 'fail':1216 'fallback':641 'fewer':371 'file':596 'filesystem':668 'find':105,320,1275 'first':289,1226,1236,1306 'fit':422,1026 'flag':47,676,677,1043,1408 'focus':1099 'follow':249 'forget':1260 'format':1003 'found':1021,1087,1319 'full':463 'g':555,694,747,789,1082,1353 'general':432 'generat':264 'git':495,1198 'git@github.com':500 'github':454,464 'github.com':470,484,891,1392 'github.com/xixu-me/skills':469 'github.com/xixu-me/skills-vault)':1391 'github.com/xixu-me/skills-vault).':890 'github.com/xixu-me/skills/tree/main/skills/skills-cli':483 'gitlab':486 'gitlab.com':492 'gitlab.com/org/repo':491 'global':547,695 'help':12,149,190,225,387,412,426,1092,1276,1280,1285,1288,1330,1413 'high':1113 'hit':1311 'identifi':253 'import':675 'improv':228 'includ':381,1064 'inconveni':647 'independ':636 'init':447,804,807,850,860,1336 'initi':186,797,841 'insid':477 'instal':34,42,52,158,163,187,296,327,333,390,399,411,448,510,519,524,534,546,557,572,582,611,620,654,680,696,729,739,764,770,817,881,910,921,941,999,1013,1037,1052,1114,1124,1346,1351,1371 'instead':240,597,700,717,1289 'interact':1337 'issu':1355 'jest':1163 'json':756,1381 'judg':268 'keep':1008 'keyword':1203 'known':293 'kubernet':1169 'leaderboard':308 'learn':405,1044,1131 'level':1103 'like':125,137,280,1017,1149,1277 'link':403 'lint':1183 'list':177,513,523,708,709,738,1368 'local':221,502,968 'look':396,1258 'ls':743,746,750,755,1376,1380 'machin':884,990,1387 'maintain':349 'mainten':736 'manag':32,49,728 'mani':1227 'manifest':925,961,986 'map':1146 'match':1030,1097 'may':142 'mention':435,664,1058,1333,1388 'method':612 'microsoft':354 'might':1091 'mistak':1247 'modul':820 'multipl':535 'my-skil':775,781,790,808 'name':93,384,684 'narrow':1241 'need':246,314 'new':799,864 'nextj':1157 'node':819 'noth':421 'npx':59,153 'offer':410 'offici':344 'older':89 'one':475,525,586,681,1269,1295 'ongo':735 'open':17 'openai':352 'openai/skills':1110,1128 'opencod':174 'option':379,1042 'os':1102 'os-level':1101 'overview':25 'owner/repo':90,1032 'owner/repo.git':501 'packag':31,157,443,503,517,666,714,801,1362 'particular':1270 'path':473,504 'pattern':511 'pdf':265 'perform':260 'playwright':1164 'plus':1244 'popular':1224 'portabl':667,985,1382 'pr':261,542 'pr-review':541 'practic':1187 'prefer':76,290,329,343,657,973 'present':377 'preview':926,948 'proceed':418 'product':1195 'project':702,1350 'prompt':707,1338 'publish':358,1117,1233 'qualiti':323,360,1035,1111,1181 'queri':1153,1305,1323 'quick':449 'react':259,1156,1204 'readm':1175 'real':1279 'recommend':325,1002,1005,1248 'refactor':1184 'refer':450 'relat':868 'remov':180,769,774,780,788,795 'repo':369,479 'repositori':359,364,1123 'reproduc':930 'reput':342 'restor':181,811,879,927,950,953,957,964,993,1385,1397 'restrict':669 'result':1253,1316 'retri':1356 'reusabl':127,277 'review':209,262,543,1182 'right':46 'run':956,1364,1373,1400 'say':423 'scope':699,703,1063,1347 'screenshot':1094,1107,1130 'search':191,315,1199,1237,1252,1297 'separ':897 'sequenc':251 'setup':933,1001 'share':997 'shorthand':455,721 'similar':356 'skeptic':375 'skill':1,3,4,10,19,23,27,36,41,57,60,83,85,92,100,107,113,147,152,154,156,165,188,214,222,237,248,278,297,319,330,367,383,446,457,467,476,481,489,498,506,514,521,526,528,530,532,536,538,540,544,549,551,553,563,565,567,574,579,584,589,591,601,603,605,656,679,685,711,724,730,740,742,745,749,754,761,765,767,771,773,777,779,783,787,792,794,800,803,806,810,815,821,826,830,843,849,859,870,882,888,893,902,908,911,922,942,977,1000,1007,1023,1027,1039,1041,1072,1074,1079,1081,1089,1093,1126,1129,1137,1229,1250,1274,1284,1292,1318,1335,1366,1375,1379,1389,1412 'skill-author':236 'skill-nam':91 'skill.md':853,867 'skills-c':531,552,566,604 'skills-lock.json':160,813 'skills.sh':155,285,287,408,1046,1134,1325,1327 'skills.sh/)':286 'skills.sh/),':1326 'skills.sh/openai/skills/screenshot':1133 'skip':706 'skvlt':946,952,963,971 'skvlt.yaml':944 'snapshot':920 'sound':124,136 'sourc':341,363,393,452,912,1031,1109,1122,1225 'source-xixu-me' 'special':139 'specif':168,199,560,689,1202,1302 'specifi':1262 'star':374 'state':1372 'stay':632 'strong':1228 'structur':1016 'subdirectori':865 'suggest':1320 'switch':1348 'symlink':599,621,643,660,719,1354 'sync':182,818,828,832 'syntax':80 'system':1193 'tailwind':1160 'target':688,1060 'task':257,271,429,1245 'team':886,996 'team-shar':995 'templat':195 'term':1213,1298 'test':204,1161,1162,1205,1210 'text':1019,1085 'tip':1200 'tool':194,869,975 'treat':366,1272 'tri':1211,1217,1299 'troubleshoot':1307 'trust':357,1116 'trustworthi':397 'typescript':1158 'ui':1189 'uncertainti':1359,1369 'unless':662 'unsupport':645 'unsur':1405 'updat':179,631,759,763,768 'url':465,487,496,1034 'use':8,37,55,88,97,98,212,234,430,678,731,887,913,1014,1121,1201,1282,1409 'user':13,72,103,217,245,415,438,615,650,698,838,874,917,981,1057,1141,1266,1310 'usual':626 'ux':1190 'vagu':1145 'vault':871,889,894,1390 'verifi':322 'volum':1115 'want':148,161,175,189,224,416,847,875,918,983,1049 'weak':1296 'web':1154 'well':292,295,347 'well-establish':346 'well-instal':294 'well-known':291 'whether':269,845,1256 'wide':1120 'window':1106 'without':518,1254 'word':1143 'work':14 'workflow':64,128,193,239,242,661,987,1196,1401 'write':226 'wrong':1345 'x':109,115,121,123,133,135 'xixu':6,460 'xixu-m':459 'y':556,571,594,610,704,835,1077,1083,1344 'yes':705","prices":[{"id":"f9c528b2-8152-4799-bd71-1d5acd60c8b2","listingId":"7af06844-7a1c-45dc-bd8c-46e598beff69","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"xixu-me","category":"skills","install_from":"skills.sh"},"createdAt":"2026-04-18T20:23:41.965Z"}],"sources":[{"listingId":"7af06844-7a1c-45dc-bd8c-46e598beff69","source":"github","sourceId":"xixu-me/skills/skills-cli","sourceUrl":"https://github.com/xixu-me/skills/tree/main/skills/skills-cli","isPrimary":false,"firstSeenAt":"2026-04-18T22:19:19.846Z","lastSeenAt":"2026-04-24T00:56:34.058Z"},{"listingId":"7af06844-7a1c-45dc-bd8c-46e598beff69","source":"skills_sh","sourceId":"xixu-me/skills/skills-cli","sourceUrl":"https://skills.sh/xixu-me/skills/skills-cli","isPrimary":true,"firstSeenAt":"2026-04-18T20:23:41.965Z","lastSeenAt":"2026-04-24T02:40:12.236Z"}],"details":{"listingId":"7af06844-7a1c-45dc-bd8c-46e598beff69","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"xixu-me","slug":"skills-cli","source":"skills_sh","category":"skills","skills_sh_url":"https://skills.sh/xixu-me/skills/skills-cli"},"updatedAt":"2026-04-24T02:40:12.236Z"}}