convez.ai
SkillAutomaçãoIntermediário
c-kick

HNL Agent Skills Registry

c-kick/hnl-agent-skills

Registro centralizado de skills reutilizáveis para agentes Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Registro centralizado e reutilizável de skills para Claude Code e Codex. Gerencia skills em um único local e distribui automaticamente para projetos via symlinks (macOS/Linux) ou junctions (Windows), permitindo atualizações sincronizadas em tempo real.

Instalação

$npx convez-ai c-kick/hnl-agent-skills

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
56
Forks
4
Acompanhando
0
Saúde
28%
Último commit
há 3 semanas
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Manter biblioteca de skills consistente entre múltiplos projetos
  • Atualizar skills uma vez e propagar mudanças automaticamente
  • Gerenciar bundles predefinidos de skills relacionadas com herança
  • Organizar skills compartilhadas entre Claude Code e Codex

Veredito

Solução prática para equipes que trabalham com múltiplos projetos Claude/Codex. O modelo de symlinks/junctions reduz duplicação e sincroniza mudanças automaticamente, mas requer configuração inicial em shell/PowerShell.

README

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

agent-skills

A centralized, local skill registry for Claude Code and Codex.

This repository contains reusable agent skills, along with a small management layer that maintains them in a single source and distributes them across projects via symlinks (macOS/Linux) or junctions (Windows).

You can add a specific skill to a project, or install a predefined bundle of skills. This does not replace the standard agent-specific skills workflow — you can still drop a SKILL.md into .claude/skills or .codex/skills manually. This adds a central home for skills you want to reuse across projects and agents.

By default, skills are installed into both .claude/skills and .codex/skills. Set AGENT_SKILLS_TARGETS to customize the target directories.

The old hnl-claude-skills.* script names and CLAUDE_SKILLS environment variable remain supported for compatibility. New installs should use agent-skills.* and AGENT_SKILLS.

Example

In your project root, run skill-add reflect. This installs the reflect skill in .claude/skills and .codex/skills as symlinks/junctions pointing to the local repository at ~/.config/agent-skills. No matter how many projects use the skill, it lives in one place — update it in the repository, and every project picks up the change immediately.

Bundles

You can also define bundles - predefined collections of skills. Example: skill-bundle-add web_development installs all skills in that bundle at once, each as a symlink/junction to the repository — the same as adding them individually. Bundles also support inheritance: web_development can extend code_development, which in turn extends general, so installing web_development pulls in the full chain automatically.


Installation

Windows (PowerShell):

  1. Clone the repository
git clone --recurse-submodules https://github.com/c-kick/hnl-agent-skills.git "$HOME/.config/hnl-agent-skills"

Note: PowerShell does not expand ~ for external programs like git. Always use $HOME instead.

The default location is ~/.config/hnl-agent-skills. To use a different path, clone there instead and set AGENT_SKILLS in your environment before sourcing the script. Existing CLAUDE_SKILLS setups still work as a fallback.

  1. Add to PowerShell profile (Run notepad $PROFILE in PowerShell*):
# Optional: set a custom location
# $env:AGENT_SKILLS = "D:\path\to\hnl-agent-skills"
# $env:AGENT_SKILLS_TARGETS = ".claude\skills;.codex\skills"
. "$HOME\.config\hnl-agent-skills\agent-skills.ps1"

If you get an error running notepad $PROFILE, this means you don't have a PowerShell profile yet. You can create one with New-Item -Path $PROFILE -ItemType File -Force

Reload your shell (in Windows PowerShell, just run . $PROFILE), done.

macOS/Linux

  1. Clone the repository
git clone --recurse-submodules https://github.com/c-kick/hnl-agent-skills.git ~/.config/hnl-agent-skills
  1. Add to ~/.bashrc or ~/.zshrc:
# Optional: set a custom location
# export AGENT_SKILLS="/path/to/hnl-agent-skills"
# export AGENT_SKILLS_TARGETS=".claude/skills .codex/skills"
. "$HOME/.config/hnl-agent-skills/agent-skills.sh"

Log out of SSH and back in again, and your bashrc should now expose all th ecommands listed below.


Commands

All commands are run from any project root you want to use the skills in.

CommandDescription
skill-lsList all skills in the registry and show target coverage
skill-ls-bundles [bundle]List all bundles and their resolved skill chains; optionally filter to one bundle
skill-ls-installedShow skills installed in configured target directories, with status
skill-add <skill> [...]Link one or more skills into all configured target directories
skill-add-allLink all skills into all configured target directories
skill-remove <skill> [...]Remove one or more skills from all configured target directories
skill-bundle-add <bundle>Install a full bundle (resolves inheritance chain)
skill-bundle-remove <bundle>Remove a full bundle (exact mirror of add)
skill-updatePull latest changes for the registry and all submodules

skill-ls status codes

StatusMeaning
installed: claude,codexSkill exists in every configured target directory
partial: claude; missing: codexSkill exists in some configured target directories, but not all

skill-ls-installed status codes

StatusMeaning
LINKEDSymlink/junction pointing into this registry — managed
EXTERNALReal directory or foreign symlink/junction — not managed, will not be touched

skill-add status codes

StatusMeaning
OKFresh junction/symlink created
ALREADY_INSTALLEDAlready linked to this registry, skipped
EXISTSReal directory or foreign junction, skipped
NOT_FOUNDSkill name does not exist in the registry

Updating skills

To update the skills from this repository, just use:

skill-update

Works from any directory, runs git pull and git submodule update --remote in the registry. All projects with linked skills pick up changes immediately — no action needed in individual projects.


Bundles

Bundles are defined in bundles.conf. Format:

[bundle-name]
extends=other-bundle,another-bundle   # optional, comma-separated
skill-one
skill-two
  • extends resolves recursively and deduplicates — installing web_development also installs everything in code_development and general.
  • Circular extends are detected and hard-error.
  • Multiple parents are supported: extends=general,code_development.

Adding your own skills

You don't have to rely on the skills that this repository gives you - you can add your own to the local repository!

Create a skill and copy its folder to ~/.config/hnl-agent-skills/ (or whichever AGENT_SKILLS path you're using). Once added, skill-add my-skill works in any project just like any other skill.


Adding an external skill repo

For skills that live in their own repository, add them as a submodule:

cd ~/.config/agent-skills   # on Windows PowerShell, use: cd "$HOME/.config/agent-skills"
git submodule add https://github.com/you/skill-repo.git skill-name
git commit -m "add: skill-name as submodule"
git push

To update a submodule to its latest version:

cd ~/.config/agent-skills   # on Windows PowerShell, use: cd "$HOME/.config/agent-skills"
git submodule update --remote skill-name
git commit -m "update: skill-name to latest"
git push

Or just run skill-update to pull everything at once.


Known limitations

skill-bundle-remove removes the full resolved chain. If you manually added a skill via skill-add before running skill-bundle-add, and that skill is part of the bundle's resolved chain, skill-bundle-remove will remove it. This is by design — remove mirrors add exactly. If you want to keep a skill after removing a bundle, re-add it manually with skill-add.

Ver o original no GitHub

Bom para

Relacionados