skillkeeper
fbpuff/skillkeeper
Windows PowerShell tool for managing local AI-agent skills across Claude Code, Codex, and other agents
Instalação
npx convez-ai fbpuff/skillkeeper1 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
README
A tradução para o português deste README ainda está na fila.
SkillKeeper
SkillKeeper v1.0.0 is a Windows-first desktop app for managing local AI-agent skills across Claude Code, Codex, and other local agents.
SkillKeeper is now an Electron + React + TypeScript desktop app, while sk.ps1 remains the CLI backend for filesystem-safe operations.
Features
- Central local skill catalog at
%USERPROFILE%\.skillkeeper\catalog. - Enable or disable skills per agent.
- Sync enabled skills into agent-specific directories with Windows junctions.
- Search, category filtering, editable categories, and expandable collection skills.
- Batch selection and one-shot sync.
- GitHub skill installation, source tracing, update preview, and update execution.
- Multi-skill repositories displayed as parent collections with child skills.
- Usage import and chart-based statistics.
- Translation settings for Chinese skill descriptions through an OpenAI-compatible API.
- Single-instance desktop behavior, tray support, and configurable close behavior.
Repository Contents
apps/desktop/ Electron desktop app
scripts/sk.ps1 CLI backend used by the desktop app
scripts/install.ps1 Local installer and shortcut creator
scripts/import-skill-usage.ps1
scripts/track-skill-usage.ps1
assets/skillkeeper.ico
PRIVACY.md
LICENSE
The repository intentionally does not include local user state such as catalog, config, logs, or backups.
Requirements
- Windows 10 or newer.
- PowerShell 7 recommended.
- Node.js and npm for local development or source-based installation.
- Git for installing and updating skills from GitHub.
- Claude Code and/or Codex installed locally if you want those integrations.
Install From Source
Clone the repository:
git clone https://github.com/fbpuff/skillkeeper.git
cd skillkeeper
Install and build the desktop app:
cd .\apps\desktop
npm install
npm run build
Install the local CLI backend and create the desktop shortcut:
cd ..\..
pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1 -CreateDesktopShortcut
Initialize local agent integration:
pwsh -NoProfile -File "$env:USERPROFILE\.skillkeeper\scripts\sk.ps1" init
Open SkillKeeper from the desktop shortcut.
Development
Run the desktop app in development mode:
cd .\apps\desktop
npm install
npm run dev
If Electron download times out on Windows, retry with a mirror:
$env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'
npm rebuild electron
Build:
npm run build
CLI Backend
The desktop app calls sk.ps1 for operations that mutate local skill state:
pwsh -NoProfile -File "$env:USERPROFILE\.skillkeeper\scripts\sk.ps1" list
pwsh -NoProfile -File "$env:USERPROFILE\.skillkeeper\scripts\sk.ps1" install owner/repo --all
pwsh -NoProfile -File "$env:USERPROFILE\.skillkeeper\scripts\sk.ps1" sync --execute
pwsh -NoProfile -File "$env:USERPROFILE\.skillkeeper\scripts\sk.ps1" update --repo owner/repo --what-if
Do not delete sk.ps1; it is part of the current desktop version.
Privacy
SkillKeeper manages local files and does not upload local catalog, config, logs, backups, API keys, or session records. See PRIVACY.md.
Limitations
SkillKeeper currently targets Windows because synchronization uses Windows junctions. Other platforms would need a separate sync implementation.
License
MIT. See LICENSE.