Manage skills
Find skills available to your organization, clone library skills, or upload local files. Managing shared organization skills and GitHub connections requires AI Operator permissions.
Find skills
aipctl skill list
aipctl skill list --search "report"
aipctl skill get SKILL_IDFind an ID in the list, then use get to view details. The details show at most 10 files, so they may not include every file in a skill.
Clone from the library
aipctl skill library --search "report"
aipctl skill clone SKILL_IDClone selected library skills into the current organization. You can pass up to five IDs at a time. If you clone several skills, check the result and new ID for each item.
AI Operator permissions are required to list and clone built-in skills.
aipctl skill built-in --search "report"
aipctl skill clone-built-in BUILT_IN_SKILL_IDUpload a local file
aipctl skill upload ./report-skill.zip
aipctl skill list --search "report"Supported formats are .zip and .skill. After uploading, use the returned ID to check the details. Standard skill commands and organization skill management commands have different upload and access scopes; choose the commands for your task.
An upload is rejected if a skill with the same name exists. Run the following only when you intend to replace it.
aipctl skill upload ./report-skill.zip --overwriteDownload a skill file
Use the ID of an organization skill you are allowed to download. Appearing in a list does not mean every skill can be downloaded.
aipctl skill download SKILL_ID -o ./downloads/report-skill.zipCLI downloads are limited to 128 MiB and 10 minutes. If a limit is exceeded, check the error and download through the web interface rather than assuming the file was saved successfully.
An existing file at the destination is overwritten. If you omit -o, the original filename is used in the current directory. Check for an existing file with that name first.
Manage shared organization skills
AI Operators can use admin skill to view and upload organization skills and control their library visibility.
aipctl admin skill list --search "report"
aipctl admin skill get SKILL_ID
aipctl admin skill upload ./report-skill.zip
aipctl admin skill download SKILL_ID -o ./downloads/report-skill.zip
aipctl admin skill publish SKILL_ID
aipctl admin skill unpublish SKILL_IDpublish makes a skill available in the library; unpublish removes its library visibility. Check the details after making a change.
Organization management commands also support listing and cloning built-in skills.
aipctl admin skill built-in --search "report"
aipctl admin skill clone-built-in BUILT_IN_SKILL_ID
aipctl admin skill listLike skill built-in and skill clone-built-in, these commands require AI Operator permissions. Cloning accepts up to five IDs at once. Check each result and the new skill IDs.
Import from GitHub
AI Operators can import organization skills from a repository or skill folder URL. Replace GITHUB_URL with the actual URL.
aipctl admin skill github inspect GITHUB_URL
aipctl admin skill github import GITHUB_URL
aipctl admin skill listInspect the repository with inspect before running import. Add --overwrite to import only when replacing a skill with the same name.
After importing, check for GitHub changes and apply them.
aipctl admin skill github sync SKILL_ID
aipctl admin skill github sync SKILL_ID --applyThe first command only checks changes. Add --apply to update the skill. Check the result with get afterward.
If a private repository requires a PAT, pass the name of an environment variable containing the token.
aipctl admin skill github inspect GITHUB_URL --pat-env GITHUB_PAT
aipctl admin skill github import GITHUB_URL --pat-env GITHUB_PATSet GITHUB_PAT in your shell first. Pass the variable name to --pat-env, not the token itself. Do not share commands, screenshots, or logs containing tokens.
Change or remove GitHub credentials
To keep synchronizing a skill imported from a private repository, you can save a PAT for that skill. This also requires AI Operator permissions.
aipctl admin skill github credentials set SKILL_ID --pat-env GITHUB_PAT
aipctl admin skill get SKILL_ID --json
aipctl admin skill github sync SKILL_IDUse the ID of an organization skill imported from GitHub. Set GITHUB_PAT to a token that can read the repository. set changes the credentials saved for the skill. Check the GitHub information returned by get to confirm a PAT is configured, then use sync to check that changes can be retrieved. The token itself is not shown in query results.
Remove the saved PAT when it is no longer needed.
aipctl admin skill github credentials clear SKILL_ID
aipctl admin skill get SKILL_ID --jsonclear removes only the PAT saved for the skill, not the skill itself. Revoke the token on GitHub separately if needed. After clearing credentials, you may need to save a valid PAT again to synchronize a private repository.
Delete a skill
Check the skill details before deleting. Use admin skill delete for shared organization skills.
aipctl skill get SKILL_ID
aipctl skill delete SKILL_ID --forceTo delete a shared organization skill:
aipctl admin skill get SKILL_ID
aipctl admin skill delete SKILL_ID --force
aipctl admin skill list--force explicitly confirms deletion. Check whether other tasks depend on the skill first. If a command stops and its result is unclear, query the list again before deciding whether to retry.