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