# Human-Friendly Style

A shared [Claude Code output style](https://code.claude.com/docs/en/output-styles) used across the [ktg-plugin-marketplace](https://git.fromaitochitta.com/open/ktg-plugin-marketplace). Gives every plugin in the marketplace a consistent, plain-language tone — so users don't have to switch mental gears when moving between plugins.

## What it does

The style modifies Claude Code's system prompt with these rules:

- **Explain what and why, not how** — describe the work in human terms; reserve technical detail for when the user asks
- **Hide noise by default** — long paths, raw commands, JSON, stack traces, and verbose tool output are summarized rather than dumped
- **Match the user's language** — Norwegian when the user writes Norwegian, English otherwise
- **Honest about uncertainty** — say "I think this should work" instead of pretending to be sure
- **Minimal formatting** — prose in conversation, lists and tables only when they genuinely help

It keeps Claude Code's normal coding instructions intact (`keep-coding-instructions: true`), so testing discipline, careful edits, and verification still apply. The style only changes how the work is communicated, not how the work is done.

## Install

Add the marketplace once, then install the plugin:

```bash
claude plugin marketplace add https://git.fromaitochitta.com/open/ktg-plugin-marketplace.git
```

In Claude Code:

```
/plugin install human-friendly-style@ktg-plugin-marketplace
```

## Activate

```
/config
```

Choose **Output style** → **Human-Friendly**.

Output styles take effect from the next session — restart Claude Code or start a new conversation to see the change.

## Use across plugins

Other plugins in this marketplace are designed to feel right with this style. To make the experience consistent, install `human-friendly-style` once and select it as your default — it then applies regardless of which plugin you use.

The style is optional. Every plugin works without it; this just makes the conversation feel more like dialog and less like a console dump.

## What's in this plugin

A single output style file at `output-styles/human-friendly.md`. Nothing else — no commands, no agents, no hooks. The plugin's only job is to ship the style file in the standard plugin location so Claude Code can auto-discover it.

## License

MIT. See [LICENSE](LICENSE).

## Issues

This plugin is part of the ktg-plugin-marketplace. Issues are welcome at the marketplace repository on Forgejo. Pull requests are not accepted — fork-and-own is the recommended adoption model. See the marketplace [GOVERNANCE.md](https://git.fromaitochitta.com/open/ktg-plugin-marketplace) for details.