# Manage Governance

> Manage governance policies for skills in config/governance.yaml. Set, remove, or list usage policies.

- Skill: `skill-mill/manage-governance` (Agent Skill)
- Install (CLI): `npx skillmds@latest add skill-mill/manage-governance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/skill-mill/manage-governance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: skill-mill (https://skillmd.com/u/skill-mill)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/skill-mill/manage-governance

---


# Manage Governance Policies

You are managing governance policies for the Agent Skill Harbor catalog.

## File

- **Config**: `config/governance.yaml`
- **Zod schema**: `web/src/lib/schemas/governance.ts`

## Schema

```typescript
usagePolicySchema: 'recommended' | 'discouraged' | 'prohibited' | 'none'

governancePolicySchema: {
  usage_policy: UsagePolicy
  note?: string
}

governanceSchema: {
  policies: Record<string, GovernancePolicySchema>  // key = skill path
}
```

## Key Format

Skill path key: `github.com/{owner}/{repo}/{skill-file-path}`

Examples:
- `github.com/example-org/code-review/.claude/skills/review/SKILL.md`
- `github.com/anthropics/prompt-library/SKILL.md`

## Actions

Parse the user's intent and execute the appropriate action below.

### Set Policy

When the user wants to set a governance policy (e.g., `govern github.com/owner/repo/SKILL.md recommended "reason"`):

1. Read `config/governance.yaml`
2. Find or create an entry under `policies` with the skill path key
3. Set `usage_policy` to one of: `recommended`, `discouraged`, `prohibited`
4. Optionally set `note`
5. Write back `config/governance.yaml`

### Remove Policy

When the user wants to remove a governance policy or set it to `none`:

1. Read `config/governance.yaml`
2. Remove the entry from `policies`
3. Write back `config/governance.yaml`

### List Policies

When the user wants to list governance policies:

1. Read `config/governance.yaml`
2. Display a table with: skill path, usage_policy, note

## Important Notes

- All changes are made to local files only
- Remind the user to create a PR to apply changes
- After making changes, run `pnpm run build:catalog` to regenerate the catalog