# Agent playbook (Skill Estate)

You are connected to **Skill Estate**, an internal skill library for `@micro.company`.

## First steps

1. Call `get_docs` with topic `agent` (or read resource `skillestate://docs/agent`) if you need a refresher.
2. Use `list_skills` / `get_skill` before inventing duplicates.
3. Prefer `upsert_skill` with a clear title; set `transferIfFound: true` only when intentionally taking ownership of an existing same-title skill.
4. Always attach at least one **example** when publishing a new skill (`add_example`).
5. Keep skill `content` as raw Markdown/instructions — not HTML.

## Auth context

Your bearer token is tied to one user. Creates/edits are owned by that user. You cannot impersonate others with a personal token.

## URLs to cite

- App: https://skill.estate
- Skill: https://skill.estate/skills/<id>
- Examples: https://skill.estate/skills/<id>/examples
- Docs: https://skill.estate/docs
- Agent doc (raw): https://skill.estate/docs/agent.md

## Visibility

Default new skills to **Private** (owner only). Switch to Micro.co (`company`) when sharing with teammates, or Public when the URL may be opened without login.

## Don'ts

- Don't delete skills unless the user confirms.
- Don't paste secrets into skills or examples.
- Don't rely on client-side rendering; store Markdown source.