Cómo usar estos skills

Instrucciones para instalar los skills de FIT en Claude Code, Cursor, Codex y otros agentes vía CLI o manualmente.

Método recomendado — CLI `npx skills`

El CLI skills (paquete oficial del ecosistema agent skills) instala cualquier skill del portal con un solo comando, en el agente que elijas (Claude Code, Cursor, Codex, OpenCode, Gemini CLI, GitHub Copilot, Windsurf, +35 más).

npx skills add FACTORIT-INGENIERIA/skills-fit-portal/skills/internal/fit-pr-description#develop

Cada página de skill muestra el comando exacto en el bloque “Instalación”.

Pre-requisitos

Node.js 18+ (para npx).
Acceso al repo vía gh auth login o SSH key cargada — el repo es privado.
Verifica acceso: ssh -T git@github.com o gh auth status.

Por qué `#develop`

El default branch del repo es develop (no main). El sufijo #develop evita ambigüedad si el CLI asume main. Cuando el repo cambie su default, este sufijo será innecesario.

Opciones útiles

# Listar skills disponibles sin instalar
npx skills add FACTORIT-INGENIERIA/skills-fit-portal#develop --list

# Instalar globalmente (~/<agent>/skills/) en lugar de en el proyecto
npx skills add <skill> -g

# Apuntar a un agente específico
npx skills add <skill> -a claude-code

# Sin prompts (CI / scripting)
npx skills add <skill> -y

Telemetría — desactivar antes del primer uso

El CLI envía señales anónimas a add-skill.vercel.sh con el source (nombre del repo) y los slugs instalados. Para evitar leakear el path del repo corporativo, todos los devs FIT deben exportar:

export DISABLE_TELEMETRY=1
# o equivalente:
export DO_NOT_TRACK=1

Añadirlo a tu ~/.bashrc o ~/.zshrc. Documentado en la auditoría del CLI.

Método alternativo — clonar manualmente

Si no querés usar npx skills (red corporativa, política, debugging):

git clone git@github.com:FACTORIT-INGENIERIA/skills-fit-portal.git
cp -r skills-fit-portal/skills/internal/fit-pr-description ~/.claude/skills/

El skill se activa automáticamente cuando Claude Code detecta contexto relevante. Para otros agentes, copiar al directorio que corresponda (~/.cursor/skills/, ~/.codex/skills/, etc.).

En la API de Claude

Incluye el contenido de SKILL.md como parte del system prompt o como contexto adicional. Ver la documentación oficial.

import Anthropic from '@anthropic-ai/sdk';
import fs from 'node:fs';

const skill = fs.readFileSync('./skills/internal/fit-pr-description/SKILL.md', 'utf-8');

const client = new Anthropic();
const response = await client.messages.create({
  model: 'claude-opus-4-7',
  max_tokens: 4096,
  system: [
    { type: 'text', text: 'Tu asistente de FACTORIT.' },
    { type: 'text', text: skill },
  ],
  messages: [{ role: 'user', content: 'Escribe la descripción de mi PR actual.' }],
});

En otros agentes

Cualquier agente que acepte instrucciones tipo system prompt puede consumir un SKILL.md. El formato es Markdown plano con frontmatter YAML — agnóstico de proveedor. El CLI npx skills resuelve la integración por agente automáticamente; la lista completa de agentes soportados está en el README del CLI.

Método recomendado — CLI npx skills