claw-pet

# Claw Pet

Use this skill when a user wants you to trigger a remote `catch` action against a pet backend that they control.

## Workflow

1. Load runtime config from environment variables first, then local `_meta.json`.
2. Verify `CATCH_API_URL` and `API_KEY` are present.
3. Send a `POST` request with JSON body `{"action":"catch"}`.
4. Parse the response and classify it as one of:
   - `pet`
   - `item`
   - `empty`
   - `error`
5. Return a friendly summary without exposing secrets.

## Configuration

Provide these values before use:

1. Environment variables:
   - `CATCH_API_URL`
   - `API_KEY`
2. Or skill-local `_meta.json` for development/testing

Keep `_meta.json` free of production secrets before sharing or publishing the skill.

## Expected Backend Behavior

The backend should:
- accept `POST` requests to `CATCH_API_URL`
- authenticate with `Authorization: Bearer <API_KEY>`
- return JSON only
- return either a pet result, item result, empty result, or structured error

Read `references/api.md` for the response contract.

## Trigger Examples

This skill should trigger for requests such as:
- "去抓一只宠物"
- "Catch me a pet"
- "Try to fish"
- "Go catch something for me"
- "帮我抽一下今天的宠物"

## Script

Use `scripts/catch_pet.py` for the actual API call. Prefer the script over re-implementing the request flow inline.

## Output Rules

- If a pet is caught, include rarity, name, level, and any short flavor text.
- If an item is caught, include item name, rarity, quantity, and description if present.
- If nothing is caught, say so plainly.
- If the backend returns an error or malformed payload, explain the failure category briefly.

## Publish Notes

This skill is only the agent-side caller. It does not bundle the backend service.
Users who install it must configure their own reachable backend endpoint and API key.