# Your Skill Name

> Use when reasoning about your custom device type in Anima. Replace this text with when the skill should trigger and what actions it can produce.

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

---


# Your Skill

This folder is a starter template for a user-authored Anima skill.

Before you use it:

1. Copy `_template/` to `skills/custom/<your-skill-name>/`
2. Rename `name:` to a real skill name
3. Replace `your_device_type` with the device type your adapter emits
4. Update the references and scripts below

## What This Skill Must Define

- When the skill should be used
- Which device types it supports
- What actions it is allowed to emit
- What counts as a safe no-op
- How preferences should be learned over time

## Load These Resources

- `references/knowledge.md` for domain rules, comfort ranges, and device interactions.
- `references/decide.md` when generating a single-device action.
- `references/learn.md` when updating the learned profile from usage history.
- `scripts/actions.py` for the runtime action helpers exposed to Anima.

## Working Rules

- Keep the description in frontmatter concrete so the skill is easy to trigger.
- Only expose actions in `scripts/actions.py` that the target adapter can execute.
- Prefer narrow, conservative decisions over broad generic prompts.

## Fill-In Checklist

- Frontmatter:
  Replace `your-skill-name` with a lowercase stable id such as `fan` or `plant_watering`.
- `metadata.device_types`:
  Must match the `device.type` values your adapter produces.
- `references/knowledge.md`:
  Add real target ranges, risk conditions, and interactions.
- `references/decide.md`:
  Keep the output schema strict. Do not let the model invent actions.
- `references/learn.md`:
  Keep the output structured. Avoid free-form essays.
- `scripts/actions.py`:
  Only keep helpers that are valid for your device.

## Common Mistakes

- Using action names that no adapter actually supports
- Forgetting to define when the correct decision is `none`
- Writing vague descriptions like "smart control for devices"
- Mixing multiple unrelated device types into one skill

