القائمة
Como criar uma skill para pi. Use quando o usuário quiser criar uma skill nova para o projeto ou para publicar como pacote.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | create-pi-skill |
| description | Como criar uma skill para pi. Use quando o usuário quiser criar uma skill nova para o projeto ou para publicar como pacote. |
Skills são o caminho mais leve para customizar o comportamento do pi. Se o problema é instrução recorrente, comece com skill. Se precisa de hooks, tools, UI ou persistência, vá de extensão.
skills/minha-skill/
└── SKILL.md
O SKILL.md é obrigatório. Scripts auxiliares são opcionais.
---
name: minha-skill
description: >
Descrição curta do que a skill faz. Aparece no prompt do pi como contexto
disponível — só a descrição, não o conteúdo completo.
---
name — identificador único, usado no comando /skill:namedescription — o que o pi mostra no system prompt para decidir quando carregarO corpo do SKILL.md são as instruções completas. O pi carrega sob demanda quando a tarefa casa com a descrição. Escreva como se estivesse instruindo o agente diretamente:
bash toolskills/minha-skill/
├── SKILL.md
└── scripts/
├── setup.sh
└── validate.mjs
No SKILL.md, referencie scripts com caminhos relativos:
## Setup
\`\`\`bash
./scripts/setup.sh
\`\`\`
Se os scripts têm dependências npm, inclua package.json na pasta de scripts.
| Escopo | Localização |
|---|---|
| Projeto | .pi/skills/minha-skill/SKILL.md |
| Global | ~/.pi/agent/skills/minha-skill/SKILL.md |
| Pacote | skills/minha-skill/SKILL.md (com pi.skills no package.json) |
{
"name": "@aretw0/minha-skill",
"keywords": ["pi-package"],
"pi": {
"skills": ["./skills"]
}
}
Publicar:
npm publish --access public
Instalar:
pi install npm:@aretw0/minha-skill
| Precisa de... | Use |
|---|---|
| Instruções recorrentes | Skill |
| Exemplos de uso de CLI | Skill |
| Templates de código | Skill |
| Hooks no ciclo de vida do pi | Extension |
| Tools customizadas para o LLM | Extension |
| UI no TUI (widgets, footers) | Extension |
| Persistência de estado | Extension |
Para padrões arquiteturais e exemplos reais de skills publicadas, consulte o agents-lab:
# Ver pacotes first-party como referência
gh api repos/aretw0/agents-lab/contents/packages --jq '.[].name'
# Ver uma skill específica
gh api repos/aretw0/agents-lab/contents/packages/git-skills/skills --jq '.[].name'
Docs relevantes no repositório:
docs/research/extension-factory-blueprint.md — design da fábricadocs/research/extension-factory-friction-analysis.md — fricções e soluçõespackages/ — exemplos vivos de pacotes publicadosFirst-party, sovereign workflows form — author, list, and validate multi-step workflow specs (YAML, DAG of block/command/agent steps with typed I/O). Use when writing or checking .workflows/*.workflow.yaml. Execution (running workflows) is delivered by SP2; this slice provides the form (workflow_list, workflow_validate).
Conduz um experimento de dogfood onde a colônia Pi executa uma task do .project/tasks.json em dois tempos (research → código) com gates do operador. Use quando o operador quiser ativar um experimento colony-experiment-phase1 ou colony-experiment-phase2.
Use when a Pi session needs to continue local-safe work with low operator friction: discover focus, interview only for missing constraints, prepare bounded slices, use workers only behind gates, checkpoint, and stop on real risk.
Interact with web pages via browser automation: navigate, click, fill forms, screenshot, and evaluate JavaScript. Uses Chrome/Chromium remote debugging (CDP).
Operar o control-plane local-first do agents-lab com board canônico, long-runs bounded, handoff/checkpoint, rollout/rollback e espelhos externos sem perder governança.
Guia o cultivo de uma primitiva reutilizável. Use quando o usuário identificar um padrão recorrente que merece ser extraído como skill, extensão ou convenção.