Skip to Content
Skip to Content
Manage skills

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_ID

Find 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_ID

Clone 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_ID

Upload 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 --overwrite

Download 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.zip

CLI 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_ID

publish 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 list

Like 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 list

Inspect 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 --apply

The 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_PAT

Set 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_ID

Use 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 --json

clear 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 --force

To 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.

Last updated on