fp-go Skill — Programação Funcional para Go
franchb/fp-go-skill
Guia automático de FP e code review para Go com fp-go/v2
Ver no GitHubSkill para Claude que fornece orientação de programação funcional para projetos Go usando fp-go/v2. Detecta automaticamente uso da biblioteca, oferece seleção interativa de monadas, revisão de código para anti-patterns, migração de código imperativo e teste baseado em propriedades com fptest-go.
Instalação
npx convez-ai franchb/fp-go-skill1 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
Casos de uso
- Escolher a monada correta (Option, Result, IOResult, ReaderIOResult, Effect)
- Revisar código fp-go e detectar anti-patterns
- Migrar código Go imperativo para pipelines funcionais
- Implementar testes baseados em propriedades com fptest-go
Veredito

Skill robusto e bem documentado para quem trabalha com fp-go/v2 em Go. Detecta automaticamente a biblioteca, oferece guia interativo com 6 camadas de documentação e cobre desde seleção de monadas até testes por propriedades. Requer expertise em programação funcional para aproveitar plenamente.
README
A tradução para o português deste README ainda está na fila.
fp-go Skill Marketplace
A Claude Code plugin marketplace providing functional programming guidance for Go projects using fp-go/v2.
Installation
Claude Code Marketplace
claude plugin marketplace add franchb/fp-go-skill
Browse and Install Plugins
/plugin menu
Local Development
To add the marketplace locally (e.g., for testing or development), navigate to the parent directory of this repository:
cd /path/to/parent # e.g., if repo is at ~/projects/fp-go-skill, be in ~/projects
claude plugin marketplace add ./fp-go-skill
What it does
- Auto-detect: When your project uses fp-go/v2 or fptest-go, Claude applies correct conventions automatically
- Monad selection: Interactive decision tree to pick the right type (Option, Result, IOResult, ReaderIOResult, Effect)
- Code review: Catches fp-go anti-patterns — wrong monad choice, imperative style, missing composition
- Migration: Step-by-step conversion of imperative Go to fp-go pipelines
- Testing: Property-based testing guidance with fptest-go — law verification, generators, FP-aware assertions, functional mocking
- Deep reference: Layered docs from compact cheatsheet to full API inventory (5,262 functions across 61 packages)
Available Plugins
| Plugin | Description |
|---|---|
| fp-go | Active FP guidance for Go projects using fp-go/v2 — monad selection, code review, migration, and testing |
Usage
Invoke with /fp-go in any Claude Code session, or start working on a Go project that imports github.com/IBM/fp-go/v2 or github.com/franchb/fptest-go — the skill activates automatically.
| Command | What it does |
|---|---|
/fp-go | Load fp-go conventions into the session |
| "which monad should I use?" | Interactive monad selection wizard |
| "review my fp-go code" | Check for anti-patterns and suggest improvements |
| "convert this to fp-go" | Step-by-step migration from imperative Go |
| "how should I test this?" | Test strategy — laws, properties, assertions, mocking |
Documentation Layers
The skill loads a compact reference (~260 lines) by default and reads deeper docs on demand:
| File | Lines | When loaded |
|---|---|---|
| SKILL.md | ~340 | Always (compact reference + guidance logic) |
| cookbook.md | 1,198 | Migration tasks, "how do I X?" |
| core-patterns.md | 1,598 | Type details, operations, composition |
| mastery.md | 1,437 | Advanced: Do-notation, DI, transformers, profunctors |
| full-reference.md | 6,080 | API lookup across all 61 packages |
| testing.md | ~900 | Property-based testing, law verification, FP assertions |
Requirements
- Go 1.24+ (for generic type aliases)
- fp-go/v2 in your project
- fptest-go (optional, for testing guidance)
Security
This skill restricts its tools to read-only operations (Read, Grep, Glob, LSP) via allowed-tools in the SKILL.md frontmatter. It cannot execute commands, write files, or make network requests.
All CI checks enforce:
- Prompt injection pattern detection on PRs
- Hidden Unicode character scanning
allowed-toolspresence verification- Content integrity hash validation
- Secret scanning with push protection
- SLSA Level 3 provenance on releases
See SECURITY.md for the vulnerability reporting policy and release verification instructions.
Contributing
We welcome contributions! Please see CLAUDE.md for skill authoring guidelines.
License
Apache-2.0