Skip to content

Latest commit

 

History

History
93 lines (66 loc) · 3.06 KB

GLOSSARY.md

File metadata and controls

93 lines (66 loc) · 3.06 KB

skillz

skillz manages the skills, plugins, marketplaces, hooks, MCP servers, and subagents that coding agents have installed. It reads each tool's native configuration as the truth and plans changes to it.

Language

Things managed

Installed: An item a coding tool reports it has, with its identity, scope, agents, and the steps that would remove it. Avoid: Entry, record

Spec: An item someone wants installed, kept in a profile or the library. Avoid: Desired item, requirement

Harness: One coding tool (Claude, Codex) that skillz reads installed state from and plans changes for. Avoid: Provider, backend, client

Scope: Whether an item applies to the user's whole machine (global) or to one project. Avoid: Level, context

Plugin id: The name@marketplace identity of a plugin; a bare name has no marketplace. Avoid: Plugin key, qualified name

Plugins list

Package: What the plugins list shows a line for: a marketplace, an owner/repo, or the installed items and library entries that share one source. Selecting it and submitting installs or removes all of it as one change. Avoid: Plugin group, bundle

Plugins list: The one interactive screen: a checkbox per package, space to select, enter to submit one plan. It has no tabs. Avoid: Workspace tabs, Project tab

Loose skills

Loose skill: A skill installed on its own rather than as part of a plugin. Avoid: Standalone skill, bare skill

Skill store: The shared directory that each agent's skill directory links into. Avoid: Skill cache, skills folder

Skill lock: The file recording where each loose skill came from and the content it was installed at. Avoid: Lockfile, manifest

Lock ownership: The rule that decides whether a skill belongs to the skill lock: the store copy is eligible; a copy in an agent directory is eligible only when the store holds no such skill. Avoid: Provenance

Hooks

Hook format: One of the layouts a tool stores hooks in. Reading and removing a hook go through the same format. Avoid: Hook syntax, hook schema

Install record: The line in a tool's plugin registry that says a plugin was installed at a scope; removed together with the plugin so the tool no longer lists it. Avoid: Registry entry, install entry

Removal

Removal plan: The steps that uninstall one Installed item. Avoid: Uninstall script, cleanup

RemovalTarget: A path that is safe to delete because it lies inside a root skillz owns. It is the only way to name a path for deletion. Avoid: Delete path, removal path

Uninstall flow: Choosing items, showing their removal plan, getting approval, executing it, and checking nothing was left behind. Avoid: Remove command

Changing state

Action: One side effect in a plan: run a command, edit a file, remove a path, or copy a subagent. Avoid: Step, operation

Profile: A named set of Specs that can be applied, inheriting from other profiles. Avoid: Preset, config

Library: The catalog of every Spec skillz has seen, independent of any profile. Avoid: Registry, catalog