vitkuz573/skillstate

Runtime de pegada de prompt O(1) para habilidades de agentes LLM de longo horizonte — implementação do SKILL.state (arXiv:2608.26263) para Claude Code e opencode

O que é skillstate?

O skillstate é um runtime leve e eficiente que reduz a pegada de prompt para habilidades de agentes LLM de longo horizonte para O(1), independentemente da duração da tarefa. Baseado no artigo SKILL.state (arXiv:2608.26263), ele permite que agentes como Claude Code e opencode mantenham o estado da habilidade sem repetir todo o contexto a cada ciclo. Isso é útil para desenvolvedores que constroem agentes complexos que precisam operar por longos períodos sem degradação de desempenho. A implementação utiliza um formato de estado compacto e persistente, garantindo que apenas informações mínimas sejam passadas entre os ciclos de execução.

Funciona com✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add vitkuz573/skillstate

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que skillstate faz?

Runtime de pegada de prompt O(1) para habilidades de agentes LLM de longo horizonte — implementação do SKILL.state (arXiv:2608.26263) para Claude Code e opencode

Visão Geral

O skillstate é um runtime projetado para gerenciar habilidades de agentes LLM de longo horizonte, mantendo a pegada de prompt constante em O(1), independentemente da duração da tarefa. Ele implementa os conceitos do artigo SKILL.state (arXiv:2608.26263), otimizando a troca de contexto entre os ciclos de execução do agente.

Recursos

  • Pegada de prompt O(1): A quantidade de tokens de prompt permanece constante, não importa quanto tempo a habilidade execute.
  • Suporte a Claude Code e opencode: Funciona nativamente com ambos os agentes.
  • Estado persistente: O estado da habilidade é armazenado em formato compacto e recuperado a cada ciclo.
  • Fácil integração: Basta adicionar como dependência e inicializar com uma linha de código.

Como Funciona

O skillstate mantém um state.json que captura apenas as informações essenciais da habilidade. Em vez de repetir todo o histórico da conversa, o agente lê e escreve nesse arquivo, mantendo a eficiência.

Instalação

npm install @vitkuz573/skillstate
# ou
pip install vitkuz573-skillstate

Uso Rápido

Para Claude Code

const skillstate = require('@vitkuz573/skillstate');
skillstate.init({ mode: 'claude' });

Para opencode

from skillstate import SkillStateRuntime
runtime = SkillStateRuntime()
runtime.run()

Documentação

Veja a documentação completa para mais detalhes.

Licença

MIT

Habilidades Relacionadas