# Write Skill

> Draft or update a portable Agent Hub skill with clean frontmatter and a practical workflow.

- **Type:** Skill
- **Install:** `agentstack add skill-sdwolf4103-opencode-agenthub-write-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sdwolf4103](https://agentstack.voostack.com/s/sdwolf4103)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sdwolf4103](https://github.com/sdwolf4103)
- **Source:** https://github.com/sdwolf4103/opencode-agenthub/tree/main/src/skills/write-skill

## Install

```sh
agentstack add skill-sdwolf4103-opencode-agenthub-write-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# write-skill

## Purpose

Create a portable Agent Hub skill as markdown, not a product-internal code registration. The outcome should be a `SKILL.md` that another hub can read, validate, and reuse.

## Workflow

1. Gather the skill's job, trigger conditions, audience, constraints, and expected outputs.
2. Draft required frontmatter first: `name`, `description`, and `when_to_use`.
3. Add optional keys only when they genuinely help, such as `allowed-tools`, `paths`, `model`, or `agent`.
4. Draft the markdown body with focused sections like purpose, workflow, boundaries, verification, and anti-patterns.
5. Run `validateSkillFrontmatter` on the draft content before presenting it as done.
6. Write the file to the correct target:
   - user home skill: `agenthub-home/skills//SKILL.md`
   - built-in hub-local skill: `src/skills//SKILL.md`
7. Verify the file exists, frontmatter parses cleanly, and the body still matches the requested behavior.

## Frontmatter quick reference

| Key | Required | Use it for |
|---|---|---|
| `name` | yes | Stable skill id |
| `description` | yes | Short operator-facing summary |
| `when_to_use` | yes | Trigger guidance for the host agent |
| `allowed-tools` | optional | Tool restrictions or hints |
| `paths` | optional | Relevant repo areas |
| `model` / `agent` / `effort` | optional | Special runtime guidance only when justified |

## Drafting rules

- Prefer one focused job per skill.
- Keep instructions reusable across repos when possible.
- Explain the decision flow, not just the final output format.
- If the skill will edit files, say what must be verified after the edit.

## Anti-patterns

- Do not stuff multiple unrelated workflows into one skill.
- Do not add optional keys just because they exist.
- Do not describe skills as Claude-only internal bundles or code-registered objects.
- Do not skip frontmatter drafting and "add it later."

## Verification

- Confirm the frontmatter has the required keys.
- Run `validateSkillFrontmatter` and fix any hard errors.
- Treat unknown-key warnings as a prompt to simplify unless the extra key is intentionally supported.
- Re-read the body to ensure headings and workflow steps are present.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sdwolf4103](https://github.com/sdwolf4103)
- **Source:** [sdwolf4103/opencode-agenthub](https://github.com/sdwolf4103/opencode-agenthub)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sdwolf4103-opencode-agenthub-write-skill
- Seller: https://agentstack.voostack.com/s/sdwolf4103
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.