convez.ai
Skill
dperezcabrera

pico-skills

dperezcabrera/pico-skills

Ver no GitHub
InicialPluginScore · de 0 a 100

Claude Code skills for the pico-framework ecosystem

Instalação

$npx convez-ai dperezcabrera/pico-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Pico-Skills

Claude Code and OpenAI Codex skills for the pico-boot ecosystem.

AI-assisted code generation following pico framework patterns and best practices.

Platform Compatibility

Pico-Skills follows the Agent Skills standard and supports multiple AI coding agents:

PlatformSkills directoryStatus
Claude Code.claude/skills/Canonical source
OpenAI Codex.agents/skills/Symlinks to .claude/skills/

The .agents/skills/ directory contains symlinks to the canonical .claude/skills/ files, so both platforms always use the same skill definitions.

Available Skills

User-invocable (slash commands)

CommandPackageDescription
/add-componentpico-iocAdd components, factories, interceptors, event subscribers, settings
/add-repositorypico-sqlalchemyAdd SQLAlchemy entities and repositories with transactions
/add-controllerpico-fastapiAdd FastAPI controllers with route decorators
/add-celery-taskpico-celeryAdd Celery worker tasks and client senders
/add-validationpico-pydanticAdd Pydantic validation to component methods
/add-agentpico-agentAdd LLM agents and tools
/add-authpico-client-authAdd JWT authentication, role-based access control, custom role resolvers
/add-server-authpico-server-authAdd embedded auth server with JWT issuance, wallet login, JWKS
/add-apppico-bootScaffold a new pico-boot application
/init-projectpico-initializerGenerate a full project with selected modules via pico-initializer CLI
/add-testsallGenerate tests for any pico component

Auto-loaded by Claude (background knowledge)

SkillDescription
pico-conventionsAPI reference and patterns for all pico-* packages. Loaded automatically when Claude detects pico framework usage.

Installation

All skills (recommended)

curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash

By default, skills are installed for both Claude Code (.claude/skills/) and OpenAI Codex (.agents/skills/).

Platform-specific installation

# Claude Code only
curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash -s -- --claude

# OpenAI Codex only
curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash -s -- --codex

Only the packages you use

curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash -s -- sqlalchemy fastapi

Base skills (pico-conventions, add-component, add-tests) are always included.

Available packages

PackageSkill installed
iocadd-component (included by default)
bootadd-app
fastapiadd-controller
sqlalchemyadd-repository
celeryadd-celery-task
pydanticadd-validation
agentadd-agent
authadd-auth

User-level (all projects)

cd ~ && curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash

Usage

/add-component UserService
/add-repository Product
/add-controller /api/orders
/add-celery-task send_notification
/add-validation UserService
/add-agent support_bot
/add-auth DatabaseRoleResolver
/add-app my-app
/add-tests UserService

Skill Structure

Each skill follows the Agent Skills standard:

pico-skills/
├── .claude/skills/                # Canonical source (Claude Code)
│   ├── add-component/SKILL.md
│   ├── add-repository/SKILL.md
│   ├── add-controller/SKILL.md
│   ├── add-celery-task/SKILL.md
│   ├── add-validation/SKILL.md
│   ├── add-agent/SKILL.md
│   ├── add-auth/SKILL.md
│   ├── add-app/SKILL.md
│   ├── add-tests/SKILL.md
│   └── pico-conventions/SKILL.md
├── .agents/skills/                # Symlinks for Codex
│   ├── add-component/SKILL.md → ../../.claude/skills/add-component/SKILL.md
│   ├── add-auth/SKILL.md → ../../.claude/skills/add-auth/SKILL.md
│   ├── add-repository/SKILL.md → ...
│   └── ...
├── install.sh
└── README.md

Pico Ecosystem Packages

PackagePyPIDescription
pico-iocPyPIIoC container (foundation)
pico-bootPyPIOrchestration & plugin discovery
pico-fastapiPyPIFastAPI integration
pico-sqlalchemyPyPISQLAlchemy + transactions
pico-celeryPyPICelery task integration
pico-pydanticPyPIPydantic validation AOP
pico-client-authPyPIJWT authentication client
pico-agentPyPILLM agent framework

Requirements

License

MIT License - see LICENSE.

Ver o original no GitHub

Bom para

Relacionados