9. Skills

Browse and manage available skills (tools).

Skill Types

Built-in Skills

Embedded in the app — cannot be disabled:

Custom Skills

Added via Gateway — can be toggled on/off:

• File read/write, command execution, web search, etc.
• Gateway or Command type

Skill Sources

• Built-in skills: bundled with the app
• Custom skills: loaded from local skill manifests (e.g., ~/.naia/skills/.../skill.json)
• Expand a skill card to check its source badge

How to Add a Custom Skill

1. Ask AI to Build It (Easiest)

Explain what you want in the chat, and Naia will write the code and create the skill.

"Build a skill that fetches the current exchange rate and save it to ~/.naia/skills/exchange/skill.json."

2. Manual Addition

1. Create a skill manifest at ~/.naia/skills/<skill-name>/skill.json
2. Place any required script/executable in the same folder
3. Open the Skills tab and check if the new skill appears
4. Enable it using the toggle
5. Test from chat with a request that should trigger the skill
6. If it doesn't appear, restart the app and check again

Notification Skills (Slack / Discord / Google Chat)

skill_notify_slack and skill_notify_discord send messages via webhooks.

Webhook Setup

Method 1: Environment Variables (Recommended)

export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/T.../B.../xxx"
export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/123/abc"

Method 2: config.json

{
  "notifications": {
    "slack": { "webhookUrl": "https://hooks.slack.com/services/T.../B.../xxx" },
    "discord": { "webhookUrl": "https://discord.com/api/webhooks/123/abc" }
  }
}

Usage Examples

• "Send a 'deploy complete' notification to Slack"
• "Post the server status report to Discord"

If no webhook is configured, setup instructions are shown.

Skill Cards

Each skill is displayed as a card with:

• Name: Skill name (e.g., skill_read_file)
• Description: One-line summary
• Click: Expand full description
• Badges: Type (built-in/gateway/command), security tier (T0~T3)
• ? button: Ask AI to explain this skill
• Toggle: Enable/disable custom skills

Search & Bulk Management

• Search: Filter by name or description
• Enable All / Disable All: Bulk toggle custom skills
• Active/total count displayed

Manage Skills via AI

Ask Naia in chat:

• "Show me the list of available skills"
• "Is there a weather-related skill?"
• "Disable the healthcheck skill"

Naia uses skill_skill_manager automatically.

Security Tiers