← DocsMarkdownIniciar sesión

Guía para agentes

Instrucciones concisas para agentes de código que usan MCP.

Estás conectado a Skillkren, una biblioteca de skills de IA reutilizables y ejemplos de su salida. Las skills siguen el formato abierto Agent Skills: un SKILL.md (instrucciones con frontmatter name y description), más archivos opcionales en references/, scripts/ y assets/.

Nombre de marca: siempre Skillkren. Dominio: skillkren.tech.

Primeros pasos

  1. Llama a get_docs con topic agent (o lee el resource https://skillkren.tech/docs/agent.md) si necesitas un recordatorio.
  2. Usa list_skills para comprobar las skills del usuario y las bibliotecas de sus equipos antes de crear duplicados. Para abrir la skill compartida de otra persona, usa get_skill con el id de su enlace.
  3. En el plan Free un usuario puede guardar hasta 25 skills; upsert_skill devuelve un error al llegar al límite. No lo evadas.
  4. Usa upsert_skill con un título claro. Actualiza tu propia skill con ese título, o crea una nueva. Pasa team para trabajar en una biblioteca de equipo.
  5. Siempre adjunta al menos un ejemplo al publicar una skill nueva (add_example).

Usar una skill

  1. Cárgala con get_skill y sigue sus instrucciones.
  2. get_skill lista los files incluidos por ruta. Lee uno con get_skill_file solo cuando las instrucciones lo indiquen o la tarea lo necesite.
  3. Usa los ejemplos de la skill como referencia de formato, tono y calidad.

Escribir una buena skill

  • Description: qué hace la skill y cuándo usarla, con las palabras que un usuario diría de verdad. Los agentes deciden si cargar una skill solo con esto.
  • Instructions (content): Markdown en bruto, no HTML. Pasos, reglas y cómo se ve una buena salida. Manténlo por debajo de unas 500 líneas.
  • References: mueve el material largo (guías de estilo, notas de API, listas de comprobación) a references/ con put_skill_file, y nombra cada archivo por su ruta en las instrucciones, p. ej. "For banned words, read references/banned-words.md". Las plantillas y los datos van en assets/, el código ejecutable en scripts/.
  • License: solo establece license (p. ej. MIT, Apache-2.0, CC-BY-4.0, Proprietary) cuando el usuario elija una. Pregunta; no elijas por él.
  • Requirements: establece compatibility solo si la skill necesita herramientas o acceso específicos.

Subir una carpeta de skill

Cuando el usuario te pida subir una skill local (por ejemplo ~/.claude/skills/pdf-processing/):

  1. Lee SKILL.md. Usa su name (como título legible), description y license; el cuerpo después del frontmatter es el content.
  2. Llama a upsert_skill con esos campos. Si la carpeta tiene un archivo LICENSE, pasa su texto como licenseText.
  3. Para cada archivo bajo references/, scripts/ y assets/, llama a put_skill_file con la misma ruta relativa, p. ej. references/forms.md.
  4. Solo archivos de texto de hasta 100 KB cada uno, 30 por skill, un subcarpeta de profundidad. Omite binarios (imágenes, PDFs) y dile al usuario qué archivos omitiste.
  5. Dale al usuario el enlace de la skill cuando termines.

Para el camino inverso, el usuario puede descargar cualquier skill como zip desde su página y descomprimirla en la carpeta de skills de su app.

Visibilidad

Las skills nuevas son Privada (solo el propietario). Las skills No listadas pueden abrirlas cualquiera con el enlace; las Públicas también aparecen en el perfil del propietario en https://skillkren.tech/u/<username>.

No puedes cambiar la visibilidad. Si el usuario quiere compartir una skill, envíalo a su página y dile que use el interruptor junto al título. Nunca sugieras compartir una skill con secretos dentro.

Contexto de autenticación

Tu conexión pertenece a un usuario. Todo lo que creas es propiedad de ese usuario, y solo puedes cambiar lo que ese usuario puede cambiar.

URLs a citar

  • App: https://skillkren.tech/app
  • Skill: usa la url que devuelven las tools. Se ve como https://skillkren.tech/u/<username>/skills/<id>.
  • Ejemplos: la URL de la skill más /examples. Referencias: la URL de la skill más /references.
  • Docs: https://skillkren.tech/docs
  • Doc del agente (en bruto): https://skillkren.tech/docs/agent.md

No hagas

  • No elimines skills ni archivos a menos que el usuario lo confirme.
  • No pegues secretos en skills, archivos o ejemplos.
  • No dependas del renderizado del cliente; guarda el origen Markdown.