Agentskill Config

agentskill-config

Storage

Two-layer JSON files with per-key override priority: project overrides global; within the same layer, ` overrides _shared`.

| Scope | Path | | --------- | ------------------------------------------ | | global | ~/.agents/skill_config.json | | project | /.agents/skill_config.json |

` is resolved via git rev-parse --show-toplevel. The project` layer path should be gitignored — personal preferences are not for team version control.

_shared is a reserved top-level key used when multiple skills share the same conceptual preference. Read applies a 4-layer automatic fallback:

1. project..
2. project._shared.
3. global..
4. global._shared.

The first non-null value is used.

---

CLI

> ` = the agentskill-config directory (resolved from the load path by the agent); = consumer skill name (e.g. git-open-pr) or _shared`.

SC=/scripts/agentskill-config.js

# Read (auto-fallback; outputs empty string and exits 0 if not found)
value=$(node "$SC" read  )

# Write (writes to the corresponding file by scope; mkdir -p automatically; idempotent merge)
# When writing to _shared, the CLI prints an impact-scope warning to stderr — agent should confirm with user before proceeding
node "$SC" write   "" --scope 

# List
node "$SC" list             # list a specific skill / _shared
node "$SC" list                # list all

# Clean (SHOULD --dry-run first to preview)
node "$SC" clean  [--scope ] [--dry-run]

For full flag details, stdout format, and exit codes, see references/api.md.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: navishachiku
• Source: navishachiku/agentskill-config
• License: MIT

Install and usage instructions live in the source repository linked above.