Hnl Agent Skills — Development skill for Claude Code

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 exter