install-akm-stash

name	install-akm-stash
description	Use when the user wants to install or clone an akm stash or individual asset from npm, GitHub, a git URL, or a local directory into their working stash.
updated	"2026-05-24T00:00:00.000Z"

Install an akm Stash

This skill is for adding a stash to the user's working stash so its assets (skills, commands, agents, knowledge, workflows, wikis, env configs, secrets, memories, lessons) become searchable and usable via akm show, akm workflow, akm tasks, or host-agent plugins.

When to use

• “Install the X stash”
• “Add the GitHub repo Y as an akm source”
• “Grab just the deploy skill from stash Z”

Prerequisite: run skill:akm-quickstart first if akm info fails.

Decision tree

1. Don't know the exact ref? Run akm curate "<keywords>" first; if needed, fall back to akm search "<keywords>" --source registry.
2. Have a stash ref? Use akm add.
3. Only want one asset? Use akm clone <ref>.

Common install patterns

From the official registry

akm search "kubernetes deploy" --source registry
akm add github:owner/kubernetes-stash
akm update
akm index

From npm

akm add npm:@acme/review-stash
akm show skill:code-review

From git or a pinned tag

akm add git+https://github.com/owner/repo.git#v1.2.3

From a local directory

akm add ./path/to/stash --name local-stash

Single asset via clone

akm clone github:owner/repo//skill:deploy
akm clone npm:@acme/stash//lesson:docker-healthchecks

Verification

akm list
akm search <asset-name>
akm show <ref> --shape agent

Private stashes

For private GitHub repos, set GITHUB_TOKEN in the environment or a secret. Secret values are never accepted on argv (that would leak via /proc/cmdline); store them as a secret and inject via env:

# Store as a whole-file secret:
printf '%s' "$GITHUB_TOKEN" | akm secret set secret:github-token

# Or store in an env asset and inject when needed:
akm env run env:user -- akm add github:your-org/private-stash

akm add github:your-org/private-stash

Pitfalls

• If two stashes expose the same asset name, use the fully-qualified ref.
• If search finds nothing after akm add, run akm index.
• Treat quality: "proposed" content as draft material until it is accepted.