Skill Hush

OpenCode plugin that suppresses verbose skill content and command template display in the TUI.

Instead of dumping 100+ lines of <skill_content> into the conversation when an agent loads a skill, it shows a one-line placeholder. The skill content still reaches the LLM context -- only the TUI display is shortened.

Before / After

Skill load -- Before:

Loaded skill: bmad-advanced-elicitation

<skill_content name="bmad-advanced-elicitation">
# Skill: bmad-advanced-elicitation

# Advanced Elicitation
**Goal:** Push the LLM to reconsider, refine, and improve its recent output.
...
Base directory for this skill: /Users/katops/git/.agents/skills/...
</skill_content>

Skill load -- After:

skill: bmad-advanced-elicitation
[Skill "bmad-advanced-elicitation" loaded]

Command template -- Before:

/commit
feat: add new feature (multi-line resolved template...)

Command template -- After:

/commit
[Command: commit]

Installation

Global (recommended)

npm install -g opencode-skill-hush

Or as a local plugin

Clone the repo and reference it directly in opencode.json:

{
  "plugin": ["/path/to/opencode-skill-hush/dist/index.js"]
}

Configuration

Add to your opencode.json:

{
  "plugin": [
    ["opencode-skill-hush", {
      "suppressSkills": true,
      "suppressCommands": true,
      "showLineCount": false
    }]
  ]
}

Options

Option	Type	Default	Description
suppressSkills	boolean	true	Replace skill tool content with placeholder
suppressCommands	boolean	true	Replace command templates with placeholder
showLineCount	boolean	false	Append line count to skill placeholder

Restart opencode after changing config.

Structure

opencode-skill-hush/
├── src/
│   ├── index.ts            # Plugin entry, exports ContentHushPlugin
│   └── hooks/
│       ├── skill.ts        # tool.execute.after handler
│       ├── command.ts      # command.execute.before handler
│       ├── chat.ts         # chat.message handler
│       └── __tests__/      # Unit tests (vitest)
├── package.json
├── tsconfig.json
└── AGENTS.md

How it works

Three hooks, one plugin:

Hook	Target	What it does
tool.execute.after	skill tool	Replaces output.title and output.output with a minimal placeholder. The tool has already finished, so the LLM context is unaffected.
command.execute.before	slash commands	Replaces output.parts with a single [Command: {name}] text part before it renders.
chat.message	TUI chat messages	Detects command templates in chat text parts and replaces them with [Command: {heading}]. Matches if the text contains a <skill_content> tag (regardless of H2 structure), or starts with an H1 heading (#) that has a / prefix and includes H2 sections (##). Minimum 50 chars. Catches templates that arrive via chat.message rather than command.execute.before.

Development

npm install
npm run typecheck
npm test

Contributing

See CONTRIBUTING.md for contribution guidelines and CODE_OF_CONDUCT.md for community standards.

Security

Report vulnerabilities via SECURITY.md.

License

MIT License. See LICENSE.