Friday AI Skills
friday-ai-codes/skills
Skills atômicas agnósticas para automação requisito→MR em agentes IA
Ver no GitHubColeção de skills agnósticas para agentes de IA que automatizam o fluxo requisito-para-MR. Funciona nativamente em Claude Code, Cursor, Codex e 70+ agentes compatíveis. Oferece orquestração atômica via MCP server com auto-bootstrap para configuração.
Instalação
npx convez-ai friday-ai-codes/skills1 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
- Automatizar pipeline completo requisição → pull request/merge request
- Analisar requisitos e gerar planos técnicos estruturados
- Integrar contexto de ferramentas de trabalho (Feishu) em análise e execução
- Roteamento inteligente de requisições para repositórios corretos
- Documentar aprendizados e casos em base de conhecimento persistente
Veredito

Solução robusta e bem-estruturada para automação de workflows de desenvolvimento. Arquitetura atômica favorece descoberta automática de skills por agentes, eliminando invocação manual. Documentação clara e instalação flexível (wizard ou CLI) reduzem fricção de onboarding.
README
A tradução para o português deste README ainda está na fila.
Friday AI Skills
Atomic, agent-agnostic Agent Skills for driving Friday AI: requirement-to-MR automation through the Friday MCP server.
Published to npm as @friday-ai-codes/skills. Also a Claude Code plugin (skills + SessionStart hook + bundled MCP server declaration).
Design
- Atomic: one skill per workflow stage, so agents auto-trigger the right one from its
description— no manual/slashinvocation needed. - MCP-first: skills drive the
@friday-ai-codes/mcpstdio server; raw HTTP is documented as fallback only. - Self-bootstrapping: when the MCP server is missing or unauthenticated, the
friday-setupskill walks the agent through install, Access Token creation, and IDE registration.
Skills
| Skill | Use it for |
|---|---|
using-friday | Meta skill: skill routing table + trace discipline (auto-injected by the plugin hook) |
friday-setup | Install/configure/repair Friday access: doctor -> init -> register -> verify |
friday-discover | Route a requirement to the right indexed repository, check index health |
friday-analyze | GraphRAG evidence, architecture/risk/test analysis, analysis_id |
friday-plan | Create or revise a coding plan (plan_id / version_id) |
friday-execute | Execute a plan, poll, summarize branch, create MR |
friday-auto | Requirement -> MR end to end (full_auto) |
friday-feishu-context | Read a Feishu work item + linked docs (context_id) |
friday-feishu-plan | Technical plan + Feishu writeback (technical_plan_id, repo task matrix) |
friday-feishu-execute | Multi-repo task execution + PR/MR + result writeback |
friday-feishu-auto | Feishu work item end to end (context -> plan -> execute -> learn) |
friday-learn | Record / search LearningCase memory |
Install
Guided (default in a terminal)
npx @friday-ai-codes/skills
Launches a short wizard: pick the scope (current project or global) and the target agents (detected on your machine — nothing is pre-selected for you). All 12 skills are always installed together; there is no per-skill selection to click through.
Non-interactive (scripts / CI / you know what you want)
Pass any targeting flag to skip the wizard:
npx @friday-ai-codes/skills install --project --agent cursor # this project, Cursor only
npx @friday-ai-codes/skills install --agent claude-code -g # global, Claude Code only
npx @friday-ai-codes/skills install --all-agents -g # everything, everywhere
npx @friday-ai-codes/skills install -y # old behavior: auto-detect all agents, global
npx @friday-ai-codes/skills install --codex-bootstrap --agent codex # plus ~/.codex/AGENTS.md bootstrap
npx @friday-ai-codes/skills list # list bundled skills
Equivalent raw skills CLI form (always non-interactive):
npx skills add friday-ai-codes/skills --skill '*' -g -y
Claude Code — as a plugin (recommended)
The plugin form adds two things skills alone cannot: a SessionStart hook that injects the using-friday meta skill into every session (superpowers-style auto-triggering), and a bundled MCP server declaration so the friday MCP server is registered on plugin install.
claude plugin add friday-ai-codes/skills
Codex
Codex has no hook mechanism; install skills plus the AGENTS.md bootstrap:
npx @friday-ai-codes/skills install --agent codex --codex-bootstrap
First use
Nothing else to configure manually — ask your agent to "set up Friday" (or just give it a Friday task). The friday-setup skill will:
- run
npx -y @friday-ai-codes/mcp doctorto diagnose; - guide you to create an Access Token in Friday Web console ("个人资料 → 访问令牌") and run
init; - run
npx -y @friday-ai-codes/mcp registerto register the MCP server into Cursor / Claude Code / Codex; - verify with a low-risk read tool call.
Manual equivalent:
npx -y @friday-ai-codes/mcp init --base-url https://friday.example.com --token <pat>
npx -y @friday-ai-codes/mcp register
Verify locally
npx skills add . --list # should report exactly 12 skills
npm run pack:dry-run # inspect the npm tarball contents
bash hooks/session-start | head -1 # valid JSON context injection
Publishing (maintainers)
npm publish --access public --tag alpha
License
MIT