arconia skills

The arconia skills commands are experimental and may change in future releases. They showcase the capabilities of the suggested Agent Skills OCI Artifacts Specification.

The arconia skills command allows you to manage agent skills for your project. Agent skills are distributed as OCI artifacts.

Skills are always installed into the default .agents/skills directory. Optionally, you can also symlink them into additional vendor-specific directories using the --agent option.

Multi-Agent Vendor Support

When adding skills with the --agent option, the skill is extracted to .agents/skills and a per-skill symbolic link is created in each vendor-specific skills directory pointing back to the primary location. This lets multiple coding agents share the same set of skills without duplicating content or OCI fetches.

On Windows, symbolic links require Developer Mode or administrator privileges. If symlinks cannot be created, Arconia falls back to a recursive directory copy automatically.
Alias(es) Skills directory

claude, claude-code

.claude/skills

vibe, mistral, mistral-vibe

.vibe/skills

continue

.continue/skills

bob, ibm-bob

.bob/skills

Multiple agents can be specified at once:

arconia skills add --ref ghcr.io/org/repo/skill:1.0.0 --agent claude --agent vibe

The agent configuration is persisted in skills.json (via the additionalBasePaths field) so that arconia skills install reproduces the same layout, and arconia skills remove cleans up all symlinks.

Commands

add

Add agent skills to your project. You must provide either direct OCI references or lookup names from a registered collection.

arconia skills add --ref ghcr.io/org/repo/skill:1.0.0
arconia skills add --name my-skill
arconia skills add --ref ghcr.io/org/repo/skill:1.0.0 --agent claude
arconia skills add --name my-skill --agent claude --agent vibe

Options

  • --ref: The OCI artifact reference for the agent skill. Can be specified multiple times.

  • --name: The skill name to look up from a registered collection. Can be specified multiple times.

  • --agent: Additional agent vendors to also install the skill for. Can be specified multiple times. See Multi-Agent Vendor Support for supported values.

  • --collection: The registered collection alias to search. If omitted, searches all registered collections.

  • --project-dir: The project root directory (defaults to the current working directory).

  • --registry-insecure: Call the OCI registry over HTTP instead of HTTPS.

  • --registry-skip-tls-verify: Allow TLS connections without validating certificates.

install

Install all agent skills declared in the project’s configuration (skills.json). If a skill entry includes additionalBasePaths, symlinks are also created in those vendor directories.

arconia skills install

Options

  • --project-dir: The project root directory (defaults to the current working directory).

  • --registry-insecure: Call the OCI registry over HTTP instead of HTTPS.

  • --registry-skip-tls-verify: Allow TLS connections without validating certificates.

list

List installed agent skills. When a skill has symlinks in additional vendor directories, those paths are shown on continuation lines.

arconia skills list

Options

  • --project-dir: The project root directory (defaults to the current working directory).

remove

Remove agent skills from the project. This deletes the skill from the primary .agents/skills directory and removes any vendor symlinks recorded in the lockfile.

arconia skills remove --name <skill-name>

Options

  • --name: (Required) The name of the agent skill to remove. Can be specified multiple times.

  • -y, --yes: Skip confirmation prompt.

  • --project-dir: The project root directory (defaults to the current working directory).

update

Update agent skills in the project. The update reads additionalBasePaths from skills.json and applies the update to all configured vendor directories.

arconia skills update
arconia skills update --name some-skill

Options

  • --name: Update a specific skill by name. Can be specified multiple times. If omitted, updates all installed skills.

  • --all: Update all agent skills in the project.

  • --project-dir: The project root directory (defaults to the current working directory).

  • --registry-insecure: Call the OCI registry over HTTP instead of HTTPS.

  • --registry-skip-tls-verify: Allow TLS connections without validating certificates.

push

Push agent skill(s) as OCI artifact(s).

arconia skills push --ref ghcr.io/org/repo/skill --path skills/my-skill --tag 1.0.0
arconia skills push --ref ghcr.io/org/repo/skill --path skills/my-skill --tag 1.0.0 --output-report
arconia skills push --all --ref ghcr.io/org/repo/skills --path skills/ --tag 1.0.0 --output-report

Options

  • --ref: (Required) The OCI artifact reference. For a single skill: the full ref. With --all: the base ref prefix.

  • --path: (Required) The path to the skill directory, or with --all: the parent directory containing skill subdirectories.

  • --tag: (Required) The semver version tag (e.g. 1.0.0).

  • --additional-tag: Additional tags to apply to the artifact.

  • --annotation: Extra annotations in key=value format.

  • --all: Discover and push all skills found as direct subdirectories of --path.

  • --output-report: Write a publish report JSON file recording the published artifact(s) including their immutable digests. Defaults to publish-skills-report.json when specified without a path. Works with both single and batch (--all) push. The report can be used for downstream operations such as collection pushing (skills collection push --from-report), artifact signing (e.g. cosign), or SLSA provenance attestation.

  • --registry-insecure: Call the OCI registry over HTTP instead of HTTPS.

  • --registry-skip-tls-verify: Allow TLS connections without validating certificates.

See Also