resources - sinrimin/harness-nexus GitHub Wiki

Resources โ€” skills, hooks, sub-agents, rules, commands

Phases 4.2โ€“4.6 + 7.1 ยท designs: resource management ยท plugin source & trust

Everything a profile can bundle besides MCP servers lives in one resources store with a kind discriminator: skill, sub_agent, rule, command, hook (MCP servers are managed separately).

Common model

  • Identified by kind:key handles; uniqueness is per (key, scope, owner).
  • kind and scope are immutable after create โ€” mutate by recreate.
  • Scope rules as everywhere: global = admin-mutate / all-read, personal = owner-only.
  • Editors produce inline content (markdown) or, for multi-file skills, inline-bundle (SKILL.md + references/ + scripts/).

Kinds

  • skill โ€” single file or bundle; may also come from a marketplace as a plugin source (see Skill hub) carrying a computed trust tier (builtin / trusted / community) plus optional pin/provenance.
  • sub_agent / rule / command โ€” single-file inline markdown.
  • hook โ€” a hooks.json document (event โ†’ command map). The supported events depend on the declared target agent; the event ร— target matrix is data, so adding support is a table edit, not a code change.

Where they go

Resources are consumed two ways: bundled into profiles for deployment, and scanned back in from machines during inventory import.