{"id":51410819,"url":"https://github.com/kuanticacl/skill-planok","last_synced_at":"2026-07-04T14:32:30.954Z","repository":{"id":367432679,"uuid":"1280791417","full_name":"kuanticacl/skill-planok","owner":"kuanticacl","description":"Skill instalable para agentes IA: experto en la API REST de PlanOK CRM (openapi/swagger completo, ES+EN)","archived":false,"fork":false,"pushed_at":"2026-06-26T00:29:33.000Z","size":63,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-26T02:14:50.748Z","etag":null,"topics":["agent-skill","claude-skill","crm-api","integration","openai-gpt","openapi","planok","rest-api"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kuanticacl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-26T00:13:03.000Z","updated_at":"2026-06-26T00:29:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kuanticacl/skill-planok","commit_stats":null,"previous_names":["kuanticacl/skill-planok"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kuanticacl/skill-planok","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuanticacl%2Fskill-planok","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuanticacl%2Fskill-planok/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuanticacl%2Fskill-planok/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuanticacl%2Fskill-planok/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kuanticacl","download_url":"https://codeload.github.com/kuanticacl/skill-planok/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuanticacl%2Fskill-planok/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35125718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-04T02:00:05.987Z","response_time":113,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skill","claude-skill","crm-api","integration","openai-gpt","openapi","planok","rest-api"],"created_at":"2026-07-04T14:32:29.760Z","updated_at":"2026-07-04T14:32:30.938Z","avatar_url":"https://github.com/kuanticacl.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PlanOK API Skill\n\n\u003e Experto en la API REST de PlanOK CRM, con la especificación OpenAPI/Swagger completa embebida.\n\u003e Expert on the PlanOK CRM REST API, with the full OpenAPI/Swagger spec embedded.\n\nUna **skill** instalable para agentes de IA (Claude Code, OpenCode, Cursor, Codex, Gemini, Windsurf, ChatGPT Custom GPT) que responde dudas técnicas sobre la API de PlanOK basándose en la documentación oficial.\n\nAn **installable skill** for AI agents (Claude Code, OpenCode, Cursor, Codex, Gemini, Windsurf, ChatGPT Custom GPT) that answers technical questions about the PlanOK API using the official documentation as source of truth.\n\n---\n\n## ¿Qué hace? / What does it do?\n\n- Responde sobre **endpoints**, autenticación, parámetros, schemas y ejemplos de la API PlanOK.\n- Cubre módulos: centralizador/leads, UTM, clientes, cotizaciones, proyectos, productos, reservas, promesas, pagos, Pok Pago, guía propietario, iConstruye y gestor.\n- Incluye un **buscador CLI local** (`scripts/search_planok_api.py`) para encontrar endpoints y schemas por palabra clave.\n- **No inventa** endpoints ni campos: si la documentación no lo declara, lo dice explícitamente.\n\n---\n\n## Plataformas soportadas / Supported platforms\n\n| Plataforma | Cómo la usa |\n|---|---|\n| Claude Code / OpenCode / Cursor / Codex / Gemini / Windsurf / VS Code Copilot | Lee `SKILL.md` + `references/` + `scripts/` |\n| ChatGPT Custom GPT | Lee `agents/openai.yaml` (interface) + knowledge uploads |\n| Cualquier agente compatible con [Agent Skills spec](https://skills.sh/) | Mismo formato `SKILL.md` |\n\n---\n\n## Instalación / Installation\n\n\u003e **Importante sobre versionado:** `npx skills` usa la sintaxis `@\u003cskill-name\u003e` (no `@\u003cversión\u003e`) para seleccionar qué skill del repo instalar. Para fijar una versión concreta, instala desde un tag de Git (`git clone --branch`) o fija el commit. El CLI instala siempre el HEAD de la rama por defecto, que en este repo apunta a la última release (actualmente `v1.0.0`).\n\u003e\n\u003e **About versioning:** `npx skills` uses the `@\u003cskill-name\u003e` syntax (not `@\u003cversion\u003e`) to pick which skill to install from a repo. To pin a specific version, use `git clone --branch \u003ctag\u003e` or pin the commit. The CLI always installs the default branch HEAD, which in this repo points to the latest release (currently `v1.0.0`).\n\n### Vía skills.sh (recomendado / recommended)\n\n```bash\n# Instalar todas las skills del repo (default)\n# Install all skills from the repo (default)\nnpx skills add kuanticacl/skill-planok -g -y\n\n# Instalar la skill específica por nombre\n# Install a specific skill by name\nnpx skills add kuanticacl/skill-planok@planok-api -g -y\n```\n\n### Manual (clonar a `~/.claude/skills/`)\n\n```bash\n# Última versión (HEAD de main) / Latest (main HEAD)\ngit clone https://github.com/kuanticacl/skill-planok.git \\\n  ~/.claude/skills/planok-api\n\n# Versión fija (tag v1.0.0) / Pin to a specific tag\ngit clone --branch v1.0.0 https://github.com/kuanticacl/skill-planok.git \\\n  ~/.claude/skills/planok-api\n```\n\n### Verificar instalación / Verify\n\n```bash\nnpx skills list -g\n# Debería listar / Should list: planok-api\n```\n\nLa skill quedará registrada como `planok-api` y se activará automáticamente cuando el agente detecte palabras clave como *endpoints*, *swagger*, *leads*, *cotizaciones*, *UTM*, *Pok Pago*, etc.\n\nThe skill is registered as `planok-api` and activates automatically when the agent detects trigger keywords like *endpoints*, *swagger*, *leads*, *cotizaciones*, *UTM*, *Pok Pago*, etc.\n\n---\n\n## Uso / Usage\n\n### Ejemplo en español\n\n\u003e **Usuario:** ¿Cómo creo un lead en el centralizador?\n\u003e\n\u003e **Skill:** Debes llamar a `POST /leads` con seguridad `JWT` (header `Authorization: Bearer \u003cJWT\u003e`).\n\u003e\n\u003e ```bash\n\u003e curl -X POST \"https://api-gci-rest.integracionplanok.io/api/leads\" \\\n\u003e   -H \"Authorization: Bearer \u003cJWT\u003e\" \\\n\u003e   -H \"Content-Type: application/json\" \\\n\u003e   -d '{\n\u003e     \"rut_dni\": \"12345678-9\",\n\u003e     \"nombre\": \"Juan\",\n\u003e     \"apellido_paterno\": \"Pérez\",\n\u003e     \"email\": \"juan@example.cl\",\n\u003e     \"telefono_movil\": \"+56912345678\",\n\u003e     \"proyecto_id\": 42,\n\u003e     \"comentario\": \"Interesado en departamento\"\n\u003e   }'\n\u003e ```\n\n### Example in English\n\n\u003e **User:** How do I authenticate to PlanOK CRM?\n\u003e\n\u003e **Skill:** Call `POST /login?apikey=\u003cAPI_KEY\u003e` with credentials, then use `Authorization: Bearer \u003cJWT\u003e` in subsequent requests that declare `JWT` security.\n\n---\n\n## Estructura / Structure\n\n```\nskill-planok/\n├── SKILL.md                          # Instrucciones + frontmatter (ES + EN)\n├── README.md                         # Este archivo / This file\n├── LICENSE                           # MIT\n├── .gitignore\n├── agents/\n│   └── openai.yaml                   # Metadata para ChatGPT Custom GPT\n├── references/                       # Fuente de verdad de la API\n│   ├── openapi.json                  # Swagger 2.0 completo (~498 KB)\n│   ├── endpoint-index.md             # Índice de operaciones\n│   ├── schemas.md                    # Resumen de definitions\n│   ├── auth.md                       # Esquemas de seguridad\n│   └── workflows.md                  # Flujos comunes\n├── scripts/\n│   └── search_planok_api.py          # Buscador CLI local\n└── evals/                            # Prompts de prueba\n    ├── 01-es-crear-lead.md\n    ├── 02-es-seguridad-proyectos.md\n    ├── 03-en-autenticacion.md\n    ├── 04-en-utm.md\n    ├── 05-es-pok-pago.md\n    └── 06-en-busqueda-cli.md\n```\n\n---\n\n## Buscador CLI / CLI search tool\n\n```bash\npython scripts/search_planok_api.py \"utm\"\npython scripts/search_planok_api.py \"cotizaciones\"\npython scripts/search_planok_api.py \"centralizador\"\npython scripts/search_planok_api.py \"promesas\"\n```\n\n---\n\n## Configuración para ChatGPT Custom GPT\n\n1. Abre [chat.openai.com/gpts/editor](https://chat.openai.com/gpts/editor).\n2. Copia el contenido de `agents/openai.yaml` en el bloque de **Instructions** (o úsalo como guía).\n3. En **Knowledge**, sube estos archivos (más livianos que el OpenAPI completo):\n   - `references/endpoint-index.md`\n   - `references/schemas.md`\n   - `references/auth.md`\n   - `references/workflows.md`\n4. Activa **Actions** si quieres que el GPT haga llamadas reales a la API (opcional).\n\n---\n\n## Base técnica / Technical base\n\n- **Base URL:** `https://api-gci-rest.integracionplanok.io/api`\n- **Swagger version:** `1.16.14`\n- **Seguridad:** `APIKey`, `APIKeyPublic`, `JWT`, `XAPIKey`, `CognitoJWT`, `NotificacionPush`, `Planok`, `SsoJWT`\n\n---\n\n## Licencia / License\n\nMIT © 2026 KUANTICA — ver [LICENSE](./LICENSE).\n\n---\n\n## Links\n\n- **Repo:** https://github.com/kuanticacl/skill-planok\n- **Releases:** https://github.com/kuanticacl/skill-planok/releases\n- **Issues:** https://github.com/kuanticacl/skill-planok/issues\n- **Skills registry:** [skills.sh](https://skills.sh/) — buscar `planok-api` (la indexación automática puede tardar unos minutos tras el push)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuanticacl%2Fskill-planok","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkuanticacl%2Fskill-planok","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuanticacl%2Fskill-planok/lists"}