Skills Lark / Feishu

Qué incluye este pack

Este pack agrupa los cinco skills de Lark / Feishu que cubren juntos toda la superficie que un agente Claude Code necesita para leer y escribir dentro de Lark Suite — chat, wiki, base, aprobaciones, y el ritual de standup diario que la mayoría de equipos corre en Lark.

El bundle asume que tienes una app Lark / Feishu nivel tenant y un par app_id / app_secret. Skill Maker y el CLI funcionan para Lark (internacional) y Feishu (China) — las superficies API son espejos, solo cambia el host.

Por qué los skills Lark son inusuales

La mayoría de integraciones "AI + Lark" se quedan en "lanza un webhook." Este pack invierte la relación: Claude Code se convierte en cliente Lark, con lecturas bidireccionales. El agente puede navegar un espacio Wiki, sacar un registro Bitable, presentar una aprobación, y responder en un hilo Messenger — todo desde su sesión normal.

Por qué importa: Lark / Feishu son el almacén canónico de documentos para la mayoría de equipos de ingeniería en China y APAC. Cuando el agente puede leer esos docs nativamente, dejas de pegarlos.

Instala en un comando

# Instala el pack completo en el proyecto Claude Code actual
tokrepo install pack/lark-feishu-skills

# O elige un skill individual
tokrepo install feishu-cli
tokrepo install daily-standup-workflow

Una vez instalado, cada skill es un SKILL.md bajo .claude/skills/ más los scripts auxiliares que el skill llama (Python o Node según upstream). En el primer uso, el skill pide LARK_APP_ID / LARK_APP_SECRET y los escribe en un .env local que añade a .gitignore.

Errores comunes

• Lark vs Feishu hosts. Mismas APIs, dominios distintos (open.larksuite.com vs open.feishu.cn). Define LARK_HOST por proyecto, no global.
• Scopes de permisos. Los skills de búsqueda Wiki y aprobaciones necesitan scopes que la app por defecto no tiene. El pre-flight del skill lista exactamente qué añadir.
• Verificación de firma webhook. feishu-events impone verificación por defecto. Desactivarla para dev local significa que tráfico de producción puede falsificar el agente — déjala, usa un túnel como Cloudflared.
• Rate limits del CLI. La suite respeta el QPS por tenant pero no coordina entre sesiones Claude. Si corres dos agentes a la vez, baja la concurrencia en feishu-cli config.
• Formato de tarjeta standup. El workflow lleva un layout por defecto; sobrescribe STANDUP_CARD_TEMPLATE si tu equipo usa plantilla custom.

Relación con otros packs

Estos skills se componen con otros dos packs:

• Anthropic Builders entrega el formato Skill mismo; este pack lo usa.
• Orquestación de Flujos (n8n, Prefect) da una alternativa cuando el standup necesita correr según calendario independiente de que Claude Code esté abierto.

Si tu stack es Slack + Notion en su lugar, el mapping es mecánico — pero espera reescribir el skill de búsqueda Wiki, ya que el modelo de permisos de Notion es fundamentalmente distinto de los ACLs de espacio Lark.

Para qué este pack solo no alcanza

Este pack cubre las APIs nivel tenant pero deja fuera tres preocupaciones adyacentes. Primero, login OAuth flujo-usuario: el bundle usa credenciales tenant, así que la autorización por usuario (donde el agente actúa como un empleado específico) necesita un skill adicional que envuelva el flujo Authorization Code. Segundo, transcripciones de voz y reuniones: Lark Meetings tiene su propio modelo de suscripción y no está en alcance aquí. Tercero, notificaciones push de app móvil: pasan por Lark Push, que requiere setup extra más allá del webhook.

Para cada gap, las páginas del registry de skills enlazan al add-on comunitario apropiado. El pack se queda estrecho a propósito — cinco skills bien probados ganan a quince a medias, y el workflow de standup ha sido el activo de mayor valor para los equipos que instalan todo.