skills MCP — Casos de uso, Instalar & Demo ao vivo

Name: skills MCP Server
Author: aahl

Por que usar

Principais recursos

Home Assistant 智能家居控制
TTS: 微软 Edge 与智谱 GLM-TTS
DuckDuckGo 搜索与 DeepWiki 文档检索
加密货币行情与天气预报
Lark/飞书工作流
影视搜索、商品比价

Demo ao vivo

Como fica na prática

skills-skill-3.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "skills-skill-3": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aahl/skills",
        "~/.claude/skills/skills"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "skills-skill-3": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aahl/skills",
        "~/.claude/skills/skills"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "skills-skill-3": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aahl/skills",
        "~/.claude/skills/skills"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "skills-skill-3": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aahl/skills",
        "~/.claude/skills/skills"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "skills-skill-3",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aahl/skills",
        "~/.claude/skills/skills"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "skills-skill-3": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/aahl/skills",
          "~/.claude/skills/skills"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add skills-skill-3 -- git clone https://github.com/aahl/skills ~/.claude/skills/skills

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: skills

How to automate a smart-home routine via Home Assistant

👤 Home Assistant users wanting voice-free automation via Claude ⏱ ~20 min intermediate

Quando usar: You want to chain actions (lights + AC + music) with conditional logic.

Pré-requisitos

Skill installed — git clone https://github.com/aahl/skills ~/.claude/skills/aahl-skills
Home Assistant URL + long-lived token — HA user profile → create token; export HA_URL, HA_TOKEN

Fluxo

List entities

列出所有与 'living_room' 相关的 Home Assistant entities。✓ Copiado

→ Entity list with current states
Define routine

我晚上 7 点到家。灯调至 60%、空调打开到 26°C、播放轻音乐。✓ Copiado

→ Sequenced service calls with expected outcome
Execute

执行这个 routine，按步骤 echo 服务调用后再执行。✓ Copiado

→ Per-step confirmation + resulting state

Resultado: A working chained automation without hand-writing HA YAML.

Armadilhas

Wrong entity selected (similar names) — Require the skill to confirm entity_id before executing service call

Generate voice notes from markdown

👤 Content creators producing audio versions ⏱ ~10 min beginner

Quando usar: You have a blog post and want a quick audio version for WeChat or podcast RSS.

Fluxo

Pick voice

用 Edge TTS 的 zh-CN-XiaoxiaoNeural 把 post.md 合成 mp3。✓ Copiado

→ Audio file produced
Upgrade for emotion

改用 GLM-TTS，声音要更自然有起伏。✓ Copiado

→ Alternate audio with different voice

Resultado: An audio version of your post ready to publish.

Post a daily digest to Lark/Feishu

👤 Team leads running Lark-based teams ⏱ ~25 min intermediate

Quando usar: Each morning you want an automated team digest.

Pré-requisitos

Lark app with message-send permission — feishu.cn open platform → app → bot → add to group

Fluxo

Compose

今天的要闻：天气、加密货币BTC/ETH价格、团队昨日 GitHub PR 摘要。✓ Copiado

→ Composed message
Send

发送到 '开发组' 群。✓ Copiado

→ Success ack from Lark API

Resultado: A daily digest landing in Lark without manual copy-paste.

Compare prices before buying

👤 Shoppers on Chinese e-commerce platforms ⏱ ~5 min beginner

Quando usar: Before clicking buy on a product across 淘宝/京东/拼多多.

Fluxo

Query

比价 'iPhone 15 Pro 256GB' 在主要平台，附链接。✓ Copiado

→ Platform-by-platform price + URL

Resultado: A price comparison with direct links.

Armadilhas

Cached / stale prices — Skill should fetch live; verify with a click-through

Combinações

Combine com outros MCPs para 10× de alavancagem

skills-skill-3 + github

Pull GitHub PR data then use AAHL skills to post a digest to Lark/Feishu

Use GitHub MCP to list this week's merged PRs in our org, then use AAHL's Lark skill to post a summary to the dev group.✓ Copiado

skills-skill-3 + filesystem

Read a local markdown file and convert it to audio with AAHL's TTS skill

Read ~/blog/latest-post.md, then use AAHL's Edge TTS to generate a Chinese audio version.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
Home Assistant control	-	Smart-home actions	HA API (local)
TTS (Edge / GLM)	text, voice	Voice content	Edge free / GLM paid
DuckDuckGo search	query	Web lookups	0
DeepWiki docs	query	Reference lookups	0
Crypto + weather	symbol or location	Daily digests	0
Lark/Feishu messaging	group, text	Team ops	Lark API free
Movie + price search	query	Daily life	0

Custo e limites

O que custa rodar

Cota de API: Free for most; GLM-TTS and some search APIs bring-your-own-key
Tokens por chamada: Low per tool call
Monetário: Mostly free
Dica: Use Edge TTS (free) unless you need GLM's emotion.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Various: HA_TOKEN, GLM API key, Lark app credentials — all in env

Saída de dados: Home Assistant (local LAN), Edge TTS (Microsoft), GLM (Zhipu), Lark (Feishu), DuckDuckGo

Home Assistant long-lived tokens grant full control of your house. Scope to a user with limited entities if possible.
Lark app permissions should be scoped to the minimum channels needed.

Solução de problemas

Erros comuns e correções

Home Assistant 401

Token expired or URL wrong (check http vs https, port 8123)

Verificar: curl -H "Authorization: Bearer $HA_TOKEN" $HA_URL/api/

Lark send fails

Bot not added to target group, or tenant_access_token expired. Re-issue.

Edge TTS silent on Linux

Install ffmpeg; Edge TTS depends on it for mp3 output

Verificar: ffmpeg -version

Alternativas

skills vs. outros

Alternativa	Quando usar	Troca
Home Assistant MCP	You want MCP semantics rather than skill prompts	Different integration shape

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills