# DeepSeek Harness Integration

Installs the full Agency roster as DeepSeek Harness (DSH) skills. Each agent
is prefixed with `agency-` to avoid conflicts with built-in skills.

## Install

```bash
./scripts/install.sh --tool dsh
```

This copies files from `integrations/dsh/` to `${DSH_HOME:-$HOME/.dsh}/skills/`
(user-wide). Set `DSH_HOME` if your Harness config lives elsewhere. For
project-scoped skills, run the installer with `DSH_SKILLS_DIR=.dsh/skills`
from your project root — this specific override takes precedence over
`DSH_HOME`, and DSH reads `<project>/.dsh/skills/` automatically.

> DSH discovers skills live (watched roots): new, renamed, or deleted skills
> reach the next catalog without a restart. No config file to edit.

## Activate a Skill

In DSH, skills are user- and model-invocable by default. Activate an agent
by its slash command or by name in conversation:

```
/agency-frontend-developer review this React component
```

or:

```
Use the agency-frontend-developer skill to review this component.
```

Available slugs follow the pattern `agency-<agent-name>`, e.g.:
- `agency-frontend-developer`
- `agency-backend-architect`
- `agency-reality-checker`
- `agency-growth-hacker`

## Regenerate

After modifying agents, regenerate the skill files:

```bash
./scripts/convert.sh --tool dsh
```

## File Format

Each skill is a `SKILL.md` file with the standard Agent-Skills frontmatter
(required `name` and `description`, strict kebab-case name) and the agent
persona as the body:

```markdown
---
name: 'agency-frontend-developer'
description: 'Expert frontend developer specializing in modern web technologies, React/Vue/Angular frameworks, UI implementation, and performance optimization'
---
...agent body...
```

This is byte-identical to the Antigravity and Osaurus skill output
(`skill-md` format), so the Agency Agents app renders it natively.

## Skill Roots Scanned by DSH

| Priority | Source | Path |
|---|---|---|
| 100 | project | `<project>/.dsh/skills` |
| 200 | project | `<project>/.agents/skills` |
| 300 | custom | `customSkillDirs` config |
| 400 | user | `${DSH_HOME:-$HOME/.dsh}/skills` (default install) |
| 500 | user | `~/.agents/skills` |

Project skills (rank 100/200) shadow user skills (rank 400/500) of the same
name, so a project install overrides the user-wide one for that project.