claude-plugins: generalize state-hygiene into a shared base plugin for all agents

This commit is contained in:
damocles 2026-07-27 13:21:00 +02:00 committed by mara
commit 1d3f22805f
5 changed files with 21 additions and 17 deletions

View file

@ -7,9 +7,9 @@
},
"plugins": [
{
"name": "state-hygiene",
"description": "Read-before-write discipline and dated-archive convention for durable agent notes/state files - use before archiving, overwriting, or pruning any notes/state file.",
"source": "./plugins/state-hygiene",
"name": "base",
"description": "hyperhive's base plugin - skills every agent needs, regardless of role. Currently: state-hygiene (read-before-write discipline and dated-archive convention for durable agent notes/state files). Add a new skill here (not a new plugin) if it applies to all agents; give it its own specialized plugin if it doesn't.",
"source": "./plugins/base",
"category": "productivity"
}
]

View file

@ -0,0 +1,7 @@
{
"name": "base",
"description": "hyperhive's base plugin - skills every agent needs, regardless of role.",
"author": {
"name": "hyperhive"
}
}

View file

@ -1,7 +0,0 @@
{
"name": "state-hygiene",
"description": "Read-before-write discipline and dated-archive convention for durable agent notes/state files.",
"author": {
"name": "hyperhive"
}
}

View file

@ -265,7 +265,7 @@ in
type = lib.types.listOf lib.types.str;
default = [
"skill-creator@claude-plugins-official"
"state-hygiene@hyperhive"
"base@hyperhive"
];
example = [
"formatter@my-marketplace"
@ -283,16 +283,20 @@ in
Defaults to Anthropic's `skill-creator` (teaches an agent to
write, refine, and evaluate its own skills) plus hyperhive's own
`state-hygiene` skill (read-before-write + dated-archive
discipline for durable notes/state files) agents get both out
of the box, matching the default marketplaces above.
`base` plugin one plugin bundling every skill that applies to
*all* agents regardless of role (currently just `state-hygiene`,
read-before-write + dated-archive discipline for durable
notes/state files; more all-agent skills land as additional
skills inside this same plugin, not new plugins a skill that
only some agents need gets its own specialized plugin instead).
Agents get both out of the box, matching the default
marketplaces above.
Note that a per-agent definition REPLACES this default rather
than extending it (ordinary NixOS list-option semantics, same as
`claudeMarketplaces`). An agent that wants extra plugins AND the
defaults should list both
`skill-creator@claude-plugins-official` and
`state-hygiene@hyperhive` alongside them.
defaults should list both `skill-creator@claude-plugins-official`
and `base@hyperhive` alongside them.
'';
};