Agent Skills › Fullive-AI/Anima › your-skill-name

your-skill-name

GitHub

Anima 自定义设备技能模板，用于定义特定设备类型的触发条件、支持动作及安全逻辑。指导用户配置元数据、知识参考及执行脚本，确保与适配器兼容并避免常见错误。

skills/custom/_template/SKILL.md Fullive-AI/Anima

Trigger Scenarios

需要为 Anima 平台开发或配置新的自定义设备控制技能时遇到设备类型不匹配或动作定义模糊的问题需参考最佳实践时

Install

npx skills add Fullive-AI/Anima --skill your-skill-name -g -y

More Options

Non-standard path

npx skills add https://github.com/Fullive-AI/Anima/tree/main/skills/custom/_template -g -y

Use without installing

npx skills use Fullive-AI/Anima@your-skill-name

指定 Agent (Claude Code)

npx skills add Fullive-AI/Anima --skill your-skill-name -a claude-code -g -y

安装 repo 全部 skill

npx skills add Fullive-AI/Anima --all -g -y

预览 repo 内 skill

npx skills add Fullive-AI/Anima --list

SKILL.md

Frontmatter

{
    "name": "your-skill-name",
    "metadata": {
        "version": "0.1.0",
        "device_types": [
            "your_device_type"
        ]
    },
    "description": "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."
}

Your Skill

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

Before you use it:

Copy _template/ to skills/custom/<your-skill-name>/
Rename name: to a real skill name
Replace your_device_type with the device type your adapter emits
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.