@cromus-ai/dsh-plugin

Readme

# @cromus-ai/dsh-plugin

**Cromus** plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — score, validate, and cost-estimate AI skills directly from the `dsh` agent.

## Install

```sh
dsh plugins add @cromus-ai/dsh-plugin
```

Then set your API key (get one at [cromus.ai/connect](https://cromus.ai/connect)):

```sh
export CROMUS_API_KEY=your_key_here
```

## Tools

Once installed, all 11 Cromus tools appear in the model's tool registry under the `mcp__cromus__` namespace:

| Model-facing name | What it does |
|---|---|
| `mcp__cromus__score_skill` | Returns a 0–1000 Croms score with a four-dimension breakdown for any skill file |
| `mcp__cromus__simulate_cost` | Estimates per-run and monthly cost across five routing modes for a given workflow |
| `mcp__cromus__check_mcp_drift` | Compares a skill's declared MCP dependencies against a live server and flags changes |
| `mcp__cromus__check_model_drift` | Detects retired, renamed, or superseded models declared in a SKILL.md |
| `mcp__cromus__validate_skill` | Checks a SKILL.md file against the open specification and lists any violations |
| `mcp__cromus__validate_mcp_deps` | Checks a skill's `mcp_dependencies` block for completeness and valid configuration |
| `mcp__cromus__validate_ethos` | Checks an ETHOS.md governance file against the open specification |
| `mcp__cromus__validate_memory` | Checks a MEMORY.md handoff file against the open specification |
| `mcp__cromus__validate_agents` | Validates an AGENTS.md file and returns a readiness score |
| `mcp__cromus__reality_check_summary` | Returns the most recent Reality Check record for a skill, read-only |
| `mcp__cromus__check_usage_waste` | Analyzes AI API usage exports for waste patterns: cache utilization, model sprawl, idle burn |

## Manual config

If you prefer to wire it in yourself, add this to your `cordis.patch.yml`:

```yaml
- insert:
    - id: cromus-mcp
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: cromus
        transport: streamable-http
        url: https://mcp.cromus.ai/mcp
        headers:
          Authorization: !!js '`Bearer ${process.env.CROMUS_API_KEY}`'
```

## Links

- [Cromus](https://cromus.ai) — AI skills governance platform
- [Connect page](https://cromus.ai/connect) — get your API key and see all integration options
- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — the plugin-based agent harness
- [Agent Plugins 1.0](https://npmjs.com/package/@cromus-ai/plugin) — for Claude Code, Cursor, Cline, and Codex

## License

MIT