convez.ai
SkillProdutividadeIntermediário
Milktang0128

MySkills

Milktang0128/myskills

Painel centralizado para gerenciar skills de IA em múltiplas plataformas

Ver no GitHub
BomPluginScore · de 0 a 100

Aplicação desktop multiplataforma (macOS/Windows/Linux) para descobrir, deduplicar, organizar e sincronizar skills de agentes IA entre Claude Code, Codex e repositórios compartilhados. Centraliza a gestão de arquivos SKILL.md em um único painel, evitando duplicatas e drift entre plataformas.

Instalação

$npx convez-ai Milktang0128/myskills

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
64
Forks
8
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v0.5.2
Issues abertas
2
Contribuidores
2

Casos de uso

  • Organizar skills reutilizáveis entre Claude Code e Codex
  • Deduplicar e sincronizar prompts e instruções de agentes
  • Auditar e versionar mudanças em capabilities de IA

Veredito

Ferramenta prática e bem pensada para quem trabalha com múltiplos agentes IA e enfrenta o problema real de fragmentação de skills. Implementação sólida com backup automático, sincronização explícita e interface clara — endereça um pain point específico do ecossistema.

README

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


MySkills is a local desktop app that scans the skill directories you've registered, deduplicates by name + source, and gives you one coherent view of every AI agent skill you have. The default registry is ~/.claude/skills, ~/.codex/skills, and ~/.agents/skills; you can add, remove, or repath platforms in Settings.

A SKILL.md is a Markdown file with YAML frontmatter that tools like Claude Code and Codex load as reusable capabilities — prompts, tooling profiles, agent instructions. Once you use more than one of those tools, copies start to drift across folders. MySkills makes that mess legible, and any write is explicit, reviewable, backed up, and recorded.

Install

Download the latest signed build for your platform:

→ Releases page

  • macOS — universal .dmg (Apple Silicon and Intel). Signed with a Developer ID certificate and stapled with Apple's notary ticket, so it opens with a normal double-click — no Terminal workaround. Requires macOS 13 (Ventura) or later. ~19 MB.
  • Windows — .exe installer (NSIS).
  • Linux — .AppImage, .deb, or .rpm.

MySkills keeps itself current: on launch it checks the stable release channel and, when a newer version is published, offers a one-click update from the notification or Settings → Updates. Updates are signature-verified before they install.

The original v0.1.x line was an Electron, Apple-Silicon-only build. It's superseded by the cross-platform Tauri builds (v0.2.0+) and kept on the releases page only for history.

On your desktop

What MySkills puts where:

  • The app data directory contains myskills.db, backups/, and staging/. (Dev/preview builds use an isolated myskills-tauri-preview directory so they never touch your real data.)
  • Automatic backups are written before every sync write; retention is configurable in Settings.
  • AI provider API keys live in the system credential store when AI features are enabled.

Your SKILL.md files are never modified by MySkills. Tags and scenarios live only in the database above.

iCloud caveat: Don't put ~/.agents/ (your main source directory) inside iCloud Drive. iCloud can "evict" files and leave .icloud placeholders that show up as broken copies — keep the main source on a local path.

What it does

See your library in one place

  • List, Kanban (by scenario), and Coverage matrix views. The matrix has one row per unique skill and one column per platform; cell colour shows which copies are in sync vs. out of sync
  • Per-skill detail drawer with last-modified time, content hash, and resolved path on disk
  • Move to main source to promote one platform's copy as the master; other platforms get a linked copy that stays in sync

Sync writes are reviewable

  • Every disk write goes through Plan → Confirm → Execute. A dialog shows you exactly what will change before anything happens
  • Destructive operations write to the app data backups/ directory first
  • One-click rollback from Sync History
  • Writes are staged through a temporary path before replacement, with rollback records for successful writes

Discover and install from skills.sh

  • Built-in search against skills.sh — a community catalog of SKILL.md skills; no account needed
  • Preview the SKILL.md from GitHub raw before installing
  • Install to any combination of platforms via the same plan-confirm-execute pipeline

AI assist (optional, bring your own API key)

  • Supports OpenAI / Anthropic / OpenRouter / DeepSeek / Ollama / any OpenAI-compatible endpoint
  • AI Lens clusters your library into themes; you can promote any cluster into a real scenario in one click
  • Auto-categorize new skills into scenarios you've defined
  • AI search in Discover re-ranks catalog results against a natural-language need
  • Create Skill turns a rough need into an editable outline, narrows key choices, generates a locally reviewed SKILL.md, and installs only after confirmation
  • Each feature has its own toggle. Keys live in the system credential store.

Privacy

  • All processing happens on your machine. No telemetry, no analytics, no background phone-home
  • The scanner only walks the folders you configure (default: ~/.claude/skills, ~/.codex/skills, ~/.agents/skills)
  • Network calls are limited to: skills.sh catalog search, and your chosen AI provider. Both are opt-in; both ship from your machine directly to the service — never via us
  • Settings has a master "Allow external network" switch — turn it off and MySkills runs fully offline

Build from source

npm install
npm run dev         # Tauri dev shell + Next.js dev (:4477)
npm run check:tauri # command bridge audit + Rust fmt/clippy/tests + frontend build
npm run validate:tauri # check:tauri + Tauri desktop bundle
npm run smoke:tauri:launch # launch bundled app and verify isolated preview DB init
npm run smoke:tauri:dmg # mount the macOS DMG and verify preview DB init
npm run smoke:tauri:fixtures # create temporary skill fixtures for desktop parity smoke
npm run build       # Next.js static export
npm run build:tauri # Tauri desktop bundle
npm run build:tauri:stable # Tauri bundle with the future stable app id
npm run smoke:tauri:launch -- --stable-migration-smoke --frontend-smoke # stable startup migration drill
npm run build:tauri:mac:signed # local Developer ID signed macOS Tauri preview
npm run notarize:tauri:mac # notarize, staple, and Gatekeeper-check the signed Tauri DMG
npm run build:tauri:updater -- --bundles app # macOS updater archive + signature
npm run updater:manifest -- --artifacts-dir dist/tauri-updater-artifacts # write latest.json for GitHub Release assets

Legacy Electron commands are kept under *:electron:legacy for the frozen v0.1.x line.

Requirements: Node 22+, npm 10+, Rust/Cargo via rustup, and platform-specific Tauri prerequisites.

Preview auto-update channel

The Tauri preview updater is intentionally release-gated:

  1. Bump package.json and src-tauri/tauri.conf.json to a newer semver version, for example 0.2.0-tauri.1.
  2. Configure GitHub Actions secrets TAURI_SIGNING_PRIVATE_KEY and TAURI_SIGNING_PRIVATE_KEY_PASSWORD.
  3. Push tauri/refactor-v0.2 or run the Tauri Preview workflow manually.
  4. After macOS, Windows, and Linux parity checks pass, CI uploads signed updater bundles plus latest.json to the tauri-preview GitHub Release.
  5. Installed preview clients show the update from Settings, and a background check can raise a non-blocking toast.

The private updater signing key must never be committed. The public key is embedded in src-tauri/tauri.conf.json; CI signs artifacts with the private key from secrets.

Architecture

The v0.2 line uses a Web control surface with a Rust backend:

SidePathStack
Backendsrc-tauri/Tauri 2, Rust, rusqlite, custom commands
Renderersrc/Next.js 15 (static export), React 19, Tailwind, shadcn/Radix
Contractshared/Plain TypeScript types and command/channel constants — dependency-free

The renderer does not receive direct filesystem, SQL, shell, or HTTP permissions. All filesystem, database, secret, and network-gated work lives behind MySkills-specific Tauri commands.

For deeper architecture see CLAUDE.md — the file is framed as an LLM coding-assistant brief, but the content is plain architecture notes worth reading. The full product spec is in SPEC.md (Chinese).

Skill identity is the pair (name, source_key). source_key is local for now and will be a repo/marketplace slug for future imports. Content is fingerprinted by SHA-256 of SKILL.md — updating a skill bumps its content_hash, not its identity. Scenarios, tags, and any user state survive edits in place.

Writes go through plan → confirm → execute:

  1. Plan is pure read: it walks the sources, classifies each cell (in_sync / stale / only_here / missing), computes diff hashes, and pre-allocates backup paths. Output is a typed SyncPlan.
  2. Confirm shows you the plan, line by line.
  3. Execute backs up first, writes to a temp dir, then atomically renames into place.

Every successful write records before_hash, after_hash, backup_path, and the original dry_run_plan in sync_history — and is rollback-able.

Roadmap

VersionThemeStatus
v0.1MVP-A — read-only inventory, scenarios, Discover, optional AIsuperseded (frozen Electron line)
v0.2Tauri rewrite — cross-platform (macOS / Windows / Linux), Rust backend, in-app auto-update, plus Create Skillshipping
v0.3+Project/plugin-level skill scanning, multi-machine awarenessplanned

Not planned:

  • General-purpose in-app skill editor — Create Skill may generate and install a reviewed SKILL.md, but long-form editing stays in your usual editor
  • Cloud sync — MySkills stays local-only by design
  • Running skills inside MySkills — execution stays with the agent tools

Status

Solo personal project. The shipping line is the cross-platform Tauri build (v0.2.x) — a Rust backend with a Next.js UI, signed and notarized on macOS, packaged for Windows and Linux, with in-app auto-update. The older Electron, macOS-only v0.1.x line is frozen. The Rust backend has unit coverage for the scanner and sync invariants, and the release workflow signs and publishes macOS / Windows / Linux artifacts on every version tag.

Contributing

Issues and PRs welcome. Before you open one:

  1. For non-trivial PRs, file an issue first. MVP scope is intentionally tight, and the architecture has invariants — skill identity, plan→confirm→execute, the IPC boundary — that are easy to violate accidentally. The short list lives in CLAUDE.md.
  2. Conventional commit style (feat:, fix:, ux:, docs:, chore:). Match the existing log.
  3. No automated tests yet. Don't claim "tests pass" — describe what you exercised manually in the PR description.

Credits

  • skills.sh — the catalog this app searches against, and the community of SKILL.md authors who made aggregation possible in the first place.
  • Built with Tauri, Next.js, shadcn/ui, and Lucide. The frozen v0.1.x maintenance line was built with Electron.

License

MIT © 2026 Milk Tang.

Ver o original no GitHub

Bom para

Relacionados