your-skill-name

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

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

skills/custom/_template/SKILL.md

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

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.

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

custom_skill_bde0ceda

当室内湿度低于40%时，自动开启智能加湿器并将目标湿度设定为50%，以维持舒适的室内湿度水平。

室内湿度持续低于40% 需要自动调节环境湿度

skills/custom/auto_turn_on_humidifier_when_humidity_below_40/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill custom_skill_bde0ceda -g -y

SKILL.md

Frontmatter

{
    "name": "custom_skill_bde0ceda",
    "metadata": {
        "device_types": [
            "humidity_sensor",
            "smart_humidifier"
        ]
    },
    "description": "Automatically activates the connected humidifier and sets its target humidity to 50% when indoor humidity drops below 40% RH"
}

Goal

Maintain indoor humidity above 40% at a comfortable level by automatically triggering the humidifier when humidity drops too low.

Load These Resources

A working connected humidity sensor that provides accurate real-time indoor humidity readings
A connected smart humidifier that supports remote control of power state and target humidity settings

Working Rules

Trigger Condition

This skill activates when the measured indoor humidity drops strictly below 40% relative humidity. It continuously monitors humidity to check for this threshold.

Core Actions

Monitor real-time indoor humidity level from the connected sensor
When humidity is confirmed to be below 40%, turn on the connected smart humidifier
Set the humidifier's target humidity to exactly 50%

Hard Constraints

Do not activate the humidifier if indoor humidity is 40% or higher
Always set target humidity to exactly 50% every time the skill triggers

Success Criteria

Humidifier is automatically turned on when indoor humidity drops below 40%
The humidifier's target humidity is correctly set to 50% after activation

custom_skill_f4b0b238

当系统确认用户离家后，自动关闭已连接的空净设备。该技能整合了家庭占用检测模块、空净远程控制处理器及核心自动化工作流，实现离家即关机的智能场景。

用户离开家且系统确认 occupancy 状态为无人

skills/custom/custom_skill_leave_home_turn_off_air_purifier/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill custom_skill_f4b0b238 -g -y

SKILL.md

Frontmatter

{
    "name": "custom_skill_f4b0b238",
    "metadata": {
        "device_types": [
            "air_purifier"
        ]
    },
    "description": "Turn off the connected air purifier immediately after the user leaves home"
}

This skill automatically triggers the shutdown of your connected air purifier once the system confirms you have left your home. Relevant files include the home occupancy detection module, air purifier remote power control handlers, and the core automation workflow for this skill.

Workday 8AM Smart Speaker Wakeup

在工作日早8点通过智能音箱触发起床闹钟，节假日自动跳过。确保在指定条件下安全、可预测地执行，缺失上下文时保持静默。

工作日早上8点非节假日

skills/custom/workday_8am_smart_speaker_wakeup/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill Workday 8AM Smart Speaker Wakeup -g -y

SKILL.md

Frontmatter

{
    "name": "Workday 8AM Smart Speaker Wakeup",
    "metadata": {
        "version": "0.1.0",
        "device_types": [
            "smart_speaker"
        ]
    },
    "description": "A recurring automated skill that triggers a wake-up alarm via connected smart speaker at 8 AM local time on workdays and skips alarms on holidays"
}

Workday 8AM Smart Speaker Wakeup

Trigger

Describe when this custom skill should be triggered.

Action

Describe what this custom skill should do when triggered.

Working Rules

Keep this skill narrowly scoped to the device types above.
Prefer safe no-op behaviour when required context is missing.

Success Criteria

The skill triggers under the intended conditions.
The skill performs the intended action safely and predictably.

air_conditioner

用于安玛环境中空调设备的冷却、加热决策及偏好学习。涵盖舒适温度、能耗启发式规则、湿度交互，并指导选择开关机、模式切换或温度设置等操作，兼顾舒适度与能效。

需要设定空调温度时需要开启或关闭空调时需要切换空调运行模式时分析空调能耗与舒适度平衡时

skills/system/air_conditioner/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill air_conditioner -g -y

SKILL.md

Frontmatter

{
    "name": "air_conditioner",
    "metadata": {
        "version": "0.1.0",
        "device_types": [
            "air_conditioner"
        ]
    },
    "description": "Use when reasoning about air conditioners in Anima. Covers comfort temperature ranges, energy heuristics, humidity interaction, and choosing `set_temperature`, `set_mode`, `turn_on`, or `turn_off`."
}

Air Conditioner

Use this skill for device-level cooling and heating decisions plus preference learning.

Load These Resources

references/knowledge.md for comfort temperatures, energy heuristics, and device interaction rules.
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 structured action helpers exposed to the runtime.

Working Rules

Optimize for comfort without ignoring energy cost.
Treat humidity side effects as part of the decision, not a separate concern.
Prefer no-op over unnecessary cycling near the target range.

air_purifier

用于Anima平台空气净化器（如米家5）的控制与推理，处理用户交互及设备设置调整请求。

用户请求控制空气净化器用户请求调整空气净化设备设置

skills/system/air_purifier/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill air_purifier -g -y

SKILL.md

Frontmatter

{
    "name": "air_purifier",
    "metadata": {
        "device_types": [
            "air_purifier"
        ]
    },
    "description": "Provides reasoning and control capabilities for air purifier devices within the Anima platform."
}

This skill is intended for use with Anima platform air purifier devices, including models like the Mijia Smart Air Purifier 5. Use this skill when processing user requests to interact with or adjust settings for connected air purifier hardware.

Relevant files in this skill package include:

actions.py: Contains the implemented supported device actions and their parameter constraints
Core skill logic files that enforce the specified safe operation, non-redundant command, and context-aware rules.

coordinator

用于Anima系统中多设备（如加湿器、空调、灯光）的协调与编排。涵盖冲突检测、协同规划及结构化多设备操作，遵循安全优先原则，通过整合资源实现高效联动。

需要同时控制多个智能家居设备时检测到设备间存在操作冲突需解决时制定跨设备的协同动作计划时

skills/system/coordinator/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill coordinator -g -y

SKILL.md

Frontmatter

{
    "name": "coordinator",
    "metadata": {
        "version": "0.1.0",
        "device_types": [
            "coordinator"
        ]
    },
    "description": "Use when coordinating multiple devices in Anima. Covers conflict detection, synergy planning, and structured multi-device actions across humidifiers, AC units, lights, and related devices."
}

Coordinator

Use this skill for cross-device orchestration when multiple devices should be considered together.

Load These Resources

references/knowledge.md for interaction rules and system-wide priorities.
references/orchestrate.md when generating a multi-device action plan.

Working Rules

Resolve conflicts before optimizing comfort.
Prioritize safety, then comfort, then energy efficiency.
Prefer a short list of coordinated actions over noisy micro-adjustments.

device_discovery

用于设备发现、局域网刷新及小米/米家账号绑定的技能。根据需求选择本地扫描或QR码引导流程，执行发现操作并明确告知下一步动作。

用户希望发现新设备需要刷新局域网库存启动小米或米家基于QR码的配网流程

skills/system/device_discovery/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill device_discovery -g -y

SKILL.md

Frontmatter

{
    "name": "device_discovery",
    "metadata": {
        "version": "0.1.0",
        "device_types": [
            "assistant"
        ]
    },
    "description": "Use when a user wants Anima to discover devices, refresh the LAN inventory, or start Xiaomi or Mi Home onboarding with a QR flow."
}

Device Discovery

Use this skill for discovery-oriented chat tasks and Xiaomi onboarding flows.

Load These Resources

references/knowledge.md for choosing between local scan and Xiaomi QR onboarding.
references/chat.md when planning the next discovery action from user chat.
scripts/actions.py for executing the chosen scan or onboarding flow.

Working Rules

Use Xiaomi QR onboarding when the user needs full Xiaomi or Mi Home account-linked discovery.
Use local scan for a quick LAN refresh that does not require user interaction.
Keep replies operational and explicit about the next action.

humidifier

用于Anima系统中加湿器/除湿器的设备级湿度控制与偏好学习。涵盖舒适度目标、季节性启发式规则，支持设置湿度、模式及开关操作，强调渐进式调整并综合水位、季节等信号生成结构化动作。

需要调节室内湿度时查询或设定舒适湿度范围时执行加湿器或除湿器的开关及模式切换时

skills/system/humidifier/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill humidifier -g -y

SKILL.md

Frontmatter

{
    "name": "humidifier",
    "metadata": {
        "version": "0.1.0",
        "device_types": [
            "humidifier",
            "dehumidifier"
        ]
    },
    "description": "Use when reasoning about humidifiers or dehumidifiers in Anima. Covers comfort humidity targets, seasonal heuristics, and choosing `set_humidity`, `set_mode`, `turn_on`, or `turn_off`."
}

Humidifier

Use this skill for device-level humidity control and preference learning.

Load These Resources

references/knowledge.md for comfort bands, device interactions, and guardrails.
references/decide.md when generating a single-device action.
references/learn.md when summarizing long-term preference patterns.
scripts/actions.py for the structured action helpers exposed to the runtime.

Working Rules

Prefer gradual target changes over abrupt swings.
Treat water level, season, sleep context, and AC/heating interaction as first-order signals.
Return structured actions only from the supported action set in scripts/actions.py.

light

用于Anima系统中智能灯光的设备级决策与偏好学习。涵盖昼夜节律亮度、色温启发式规则、平滑过渡及开关控制，依据时间OfDay和现有状态生成最优灯光动作或返回无操作。

需要调整智能灯光的亮度和色温时根据昼夜节律优化室内照明环境时判断当前灯光设置是否合理并决定是否需要更改时

skills/system/light/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill light -g -y

SKILL.md

Frontmatter

{
    "name": "light",
    "metadata": {
        "version": "0.1.0",
        "device_types": [
            "light",
            "ceiling_light",
            "desk_lamp",
            "led_strip"
        ]
    },
    "description": "Use when reasoning about smart lights in Anima. Covers circadian brightness and color-temperature heuristics, smooth transitions, and choosing `set_brightness`, `set_color_temp`, `turn_on`, or `turn_off`."
}

Light

Use this skill for device-level lighting decisions and preference learning.

Load These Resources

references/knowledge.md for circadian lighting rules and energy heuristics.
references/decide.md when generating a single-device action.
references/learn.md when summarizing long-term lighting preferences.
scripts/actions.py for the structured action helpers exposed to the runtime.

Working Rules

Prefer smooth transitions over abrupt jumps.
Treat time of day as a primary signal for brightness and color temperature.
If current lighting is already reasonable, return none.

skill_creator

用于将用户的自然语言需求转化为位于 skills/custom/ 目录下的自定义技能包。通过先分析工作流、触发条件和约束，再按规范生成 SKILL.md 等文件，确保技能清晰且一致。

用户要求创建新技能用户要求生成自定义技能包用户要求脚手架化技能

skills/system/skill_creator/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill skill_creator -g -y

SKILL.md

Frontmatter

{
    "name": "skill_creator",
    "metadata": {
        "version": "0.1.0",
        "device_types": [
            "skill_creator"
        ]
    },
    "description": "Use when the user asks Anima to create, generate, scaffold, or customize a new skill package from a natural-language requirement."
}

Skill Creator

Use this skill for turning a user request into a new custom skill package under skills/custom/. Work analysis-first: extract the repeatable workflow, trigger, inputs, constraints, and success criteria before generating any files.

Load These Resources

references/knowledge.md for packaging rules and generation constraints.
references/chat.md when deciding whether to create a new skill from user chat.
scripts/actions.py for the runtime file-generation workflow.

Working Rules

Generate skills only inside skills/custom/.
Preserve the same package shape as built-in skills: SKILL.md, references/, and optional scripts/.
Prefer clear, conservative skills over overly broad generic automations.
If the request is ambiguous, ask for clarification instead of generating a vague skill.
Keep the generated skill aligned across all files: the trigger, supported actions, no-op boundary, and learned preferences must describe the same workflow.

speaker

用于处理Anima平台中音箱设备（如小爱同学）的播放控制与推理逻辑。当用户请求涉及音箱音乐播放、暂停、切换等基础控制操作时触发，确保交互安全且符合能力定义。

用户请求播放音乐或音频用户请求控制音箱播放状态（如暂停、停止）

skills/system/speaker/SKILL.md

View Skill ›

npx skills add Fullive-AI/Anima --skill speaker -g -y

SKILL.md

Frontmatter

{
    "name": "speaker",
    "metadata": {
        "device_types": [
            "speaker"
        ]
    },
    "description": "Handles reasoning and control for speaker devices in the Anima platform."
}

Speaker Device Skill

This skill manages control and reasoning for speaker devices such as Xiaomi Smart Speaker within the Anima platform. Use this skill when processing user requests related to speaker playback and basic speaker control.

Key relevant files:

actions.py: Implements the supported playback and control actions for speaker devices.
Follow the defined hard rules and knowledge points to ensure safe, non-redundant, and capability-aligned device interactions.

Fullive-AI/Anima

Fullive-AI/Anima

Install All Skills

Skills in Collection (12)

Your Skill

What This Skill Must Define

Load These Resources

Working Rules

Fill-In Checklist

Common Mistakes

Goal

Load These Resources

Working Rules

Trigger Condition

Core Actions

Hard Constraints

Success Criteria

Workday 8AM Smart Speaker Wakeup

Trigger

Action

Working Rules

Success Criteria

Air Conditioner

Load These Resources

Working Rules

Coordinator

Load These Resources

Working Rules

Device Discovery

Load These Resources

Working Rules

Humidifier

Load These Resources

Working Rules

Light

Load These Resources

Working Rules

Skill Creator

Load These Resources

Working Rules

Speaker Device Skill

文库