Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Recibe enlaces o textos compartidos de TikTok, Xiaohongshu, WeChat Video y otras plataformas de video corto, consulta datos de videos/cuentas, extrae transcripciones de voz y las archiva como Markdown por autor y título.

¿Qué es Tony-Claude-Code-Skills?

Esta skill permite a un agente de IA procesar enlaces de plataformas de video corto como TikTok (Douyin), Xiaohongshu (RED) y WeChat Video. Su función principal es extraer datos estructurados del video (como estadísticas de la publicación o perfil del autor) a través de la API de TikHub, y obtener la transcripción de voz del video mediante la API de QingDou. El agente puede operar en tres modos: recuperar solo datos, solo transcripción, o ambos. El resultado se entrega como un resumen JSON y un archivo Markdown guardado localmente en una estructura de carpetas por autor y título. Es especialmente útil para usuarios que necesitan analizar contenido de video corto, extraer guiones o mantener un archivo local de videos. La skill verifica automáticamente la disponibilidad de las claves de API antes de cada ejecución, y si faltan, guía al usuario paso a paso (sin compartir claves en el chat) para adquirirlas de forma segura. Solo procede si al menos un servicio está configurado, y maneja errores parciales sin descartar los resultados ya obtenidos.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/dbs-video-extract

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

dbs-video-extract: Extracción de información de videos cortos

Objetivo: Procesar un texto compartido de un mismo video corto desde una única entrada. TikHub proporciona datos estructurados de TikTok (Douyin), Xiaohongshu y WeChat Video; QingDou proporciona la transcripción de voz del video corto. Finalmente se devuelve un resumen de datos y la ruta del archivo Markdown de la transcripción.

Verificar credenciales primero

Antes de iniciar cualquier extracción, ejecuta la verificación previa de solo lectura:

python3 scripts/extract_video.py --check-keys

Maneja según el credential_state:

EstadoCapacidadDebe informar al usuario
completeTanto datos como transcripción disponiblesSe pueden ejecutar ambas partes
data_onlySolo disponible la consulta de datos TikHubSolo se pueden obtener datos del video/cuenta, no se puede generar transcripción
transcript_onlySolo disponible la transcripción de QingDouSolo se puede obtener la transcripción, no se pueden consultar datos de TikHub
unavailableNinguna de las dos partes disponibleActualmente no se puede usar; primero explica las credenciales de uso, luego guía al usuario para completar la compra y configuración

Si solo hay una clave, se permite continuar sin exigir la otra. Antes de ejecutar, explica claramente qué parte se puede resolver esta vez y, por defecto, reduce el modo a la parte disponible. Si el usuario sigue solicitando both, conserva los resultados de la parte disponible y marca la otra como falta de credenciales.

Si no hay ninguna clave, detén la extracción. No uses directamente términos como «API Key» o «autenticación de interfaz» como conclusión. Primero explica con esta frase:

Para que esta Skill funcione, primero es necesario activar servicios externos. La API Key es un conjunto de credenciales que el proveedor entrega al activar el servicio; se puede entender como el pase de acceso para que esta Skill invoque el servicio. No necesitas entender los detalles técnicos y no debes compartirla en el chat.

Luego informa al usuario: «Actualmente ningún servicio está activado. Si no compras y configuras al menos uno, esta Skill no podrá usarse.» Después, sigue references/api-setup.md para completar la selección de necesidades, compra, guardado de credenciales y prueba de conexión.

No pagues por el usuario, aceptes acuerdos de servicio ni proceses claves completas. No le pidas al usuario que envíe la clave en la conversación. La entrada de compra, la guía paso a paso, los scripts de configuración segura y la prueba de conexión se encuentran en references/api-setup.md.

Cada vez que muestres al usuario una dirección de compra o recarga, primero debes mostrar exactamente este aviso, sin omitir ni modificar:

dbskill es un proyecto gratuito y de código abierto, sin afiliación, colaboración o relación de intereses con TikHub ni QingDou. La recarga es decisión del usuario; las transacciones, servicios, disputas y riesgos relacionados son responsabilidad del usuario; salvo que la ley disponga lo contrario, dbskill no asume responsabilidad alguna.

No repitas el aviso si el usuario no ha entrado en la guía de compra o recarga.

Requisitos de diálogo cuando faltan credenciales

Si falta alguno de los servicios, la respuesta debe seguir esta ruta continua:

  1. Primero explica qué es una API Key en lenguaje sencillo;
  2. Pide al usuario que elija según el resultado: función completa, solo datos, solo transcripción;
  3. Explica qué servicio debe comprar para cada opción y qué se pierde si solo compra uno;
  4. Muestra el aviso legal fijo y luego las direcciones de recarga correspondientes;
  5. Explica paso a paso: registrarse/iniciar sesión, ver planes en la página, recargar, ir al centro personal o página de gestión de claves, obtener las credenciales;
  6. Indica al usuario que, una vez obtenidas, no las envíe al chat, sino que responda «TikHub recargado», «QingDou recargado» o «ambos recargados»;
  7. Cuando el usuario confirme la recarga, guíalo para ejecutar el script de configuración segura en su terminal local:
python3 scripts/configure_api_key.py tikhub
python3 scripts/configure_api_key.py qingdou

El script leerá las credenciales de forma oculta en la terminal y las guardará en una configuración local privada; no se debe mostrar la credencial completa en comandos, respuestas ni registros. Tras guardar, vuelve a ejecutar --check-keys hasta que el estado correspondiente esté disponible.

No envíes solo enlaces de una vez ni asumas que el usuario sabe dónde encontrar las credenciales. Si los nombres de las páginas del proveedor cambian, guía con ubicaciones candidatas como «Centro personal», «API Key», «Gestión de claves», «Configuración de desarrollador»; si aún no se encuentra, pide al usuario que envíe una captura de pantalla de la página con la cuenta, saldo y credenciales cubiertos, y continúa localizando.

Si el usuario solo invoca esta Skill sin proporcionar un enlace o especificar el tipo de resultado deseado, tras completar la verificación previa de credenciales, solo haz dos cosas: explica qué es una API Key y pide al usuario que responda 1, 2 o 3 para elegir función completa, solo datos o solo transcripción. Tras recibir la elección, muestra el aviso legal, las direcciones de recarga correspondientes y los pasos de compra. Si el usuario ya ha enviado un enlace de video o solicita explícitamente una extracción completa, por defecto elige la función completa, sin necesidad de preguntar de nuevo.

Ejecución predeterminada

Usa preferentemente la entrada estándar para evitar que los caracteres especiales del texto compartido sean interpretados por el shell:

python3 scripts/extract_video.py \
  --output-dir "/ruta/absoluta/Transcripciones_Videos_Cortos" \
  --stdin

El modo predeterminado es both:

  1. Extrae el enlace del texto compartido completo;
  2. Según la plataforma del enlace, llama al MCP de TikHub: TikTok (Douyin) admite perfil de usuario o publicación individual; Xiaohongshu y WeChat Video admiten video individual;
  3. Conserva el texto compartido completo y lo envía a la API de QingDou, sondeando hasta obtener la transcripción;
  4. Guarda la transcripción en {directorio_salida}/{autor}/{título}.md;
  5. Genera un resumen JSON que incluye el estado de las credenciales, el resumen de datos de TikHub y la ruta del archivo de transcripción.

Si falla TikHub o QingDou, continúa con la otra parte y marca partial_success en el resumen. Los resultados ya obtenidos no se descartan por un fallo unilateral.

Modo opcional

Solo se cambia al modo solicitado cuando el usuario explícitamente solo requiere un resultado, o la verificación previa confirma que solo hay clave de un lado:

python3 scripts/extract_video.py --mode data --stdin
python3 scripts/extract_video.py --mode transcript --stdin
  • data: Solo consulta datos de TikHub, compatible con TikTok (Douyin), Xiaohongshu y WeChat Video;
  • transcript: Solo extrae la transcripción, compatible con las plataformas que la API de QingDou pueda analizar;
  • both: Ejecuta ambas partes simultáneamente.

Si ya existe un archivo de transcripción para la misma fuente, se omite su escritura por defecto para proteger las ediciones del usuario; si el usuario solicita explícitamente regenerar, se añade --overwrite. Si se necesita la respuesta completa de TikHub, se añade --raw-data.

Claves y costos

El script lee las claves en el siguiente orden:

  1. Variables de entorno: TIKHUB_API_KEY, QINGDOU_API_KEY;
  2. Archivo local especificado por el usuario: TIKHUB_API_KEYS_FILE, QINGDOU_API_KEYS_FILE;
  3. ~/.config/dbs/API_Keys.md;
  4. Llavero de macOS: dbs-tikhub-api-key, dbs-qingdou-api-key.

Está prohibido escribir claves en la Skill, parámetros de comandos, Markdown, Git o registros. Tanto las consultas a TikHub como las transcripciones de QingDou pueden generar costos; informa al usuario antes de ejecutar. Si el usuario ya ha solicitado explícitamente la extracción, no es necesario confirmar de nuevo.

Límites de datos

  • TikHub se encarga de los datos de publicación/cuenta, estadísticas e información de metadatos del medio; las publicaciones de TikTok (Douyin) priorizan App V3, y si no hay datos válidos, solo se realiza un reintento con Web; Xiaohongshu usa App V2 para notas de video; WeChat Video usa Channels V2 para detalles de publicación.
  • QingDou se encarga de la transcripción de voz. El contenido del texto se conserva fielmente tal como lo devuelve la API, sin añadir, pulir ni corregir errores orales.
  • Actualmente, la interpretación de datos dedicada de TikHub es compatible con TikTok (Douyin), Xiaohongshu y WeChat Video; otras plataformas reconocibles por QingDou aún pueden ejecutar solo la extracción de transcripción.
  • Las restricciones de visibilidad (público, eliminado, privado, derechos de autor, etc.) se basan en lo que devuelve la interfaz; no se intenta eludirlas.
  • No se descargan medios automáticamente, no se publica contenido, no se envía a Git ni se realiza push.

Los detalles de la llamada a TikHub se encuentran en references/tikhub-api.md; los códigos de estado y la lógica de compatibilidad de QingDou se encuentran en references/qingdou-api.md. Solo se deben leer al depurar o mantener la parte correspondiente.

Entrega

Al finalizar, informa de forma concisa:

  • Qué clave API está configurada y el alcance de las capacidades disponibles;
  • Si la consulta de datos fue exitosa, la herramienta MCP utilizada y si ocurrió un retroceso de App a Web;
  • Datos clave del video/cuenta;
  • Si la transcripción fue exitosa, la ruta absoluta del Markdown generado o saltado;
  • La razón específica si falta una clave unilateral o si la ejecución falló;
  • Si la interfaz indicó explícitamente que ya se ha cobrado.

No muestres en la respuesta la API Key, batchId ni identificadores internos de solicitud innecesarios.

Una vez completada la tarea actual, finaliza directamente. Solo si el usuario pregunta explícitamente por el siguiente paso y el entorno ya tiene instalado /dbs, da una breve pista: «Si no estás seguro del siguiente paso, puedes escribir /dbs.»

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-Skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

shengdabai/Tony-Claude-Code-Skills

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

shengdabai/Tony-Claude-Code-Skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

shengdabai/Tony-Claude-Code-Skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Skills relacionados