agent-skills

Source of skills and rules delivered per-run into AI coding agents by axskills.

axskills fetches this repository (j4k/agent-skills on code.j4k.dev, main) as a zip archive, caches it, and copies the skills and rules you select into a throwaway config overlay for a single agent launch — nothing here is written permanently into ~/.claude, ~/.codex, and the like.

Layout

skills/
  <skill-name>/
    SKILL.md            # YAML frontmatter with `name` + `description`, then the skill body
    <supporting files>  # optional references, scripts, assets — copied verbatim
rules/
  <category>/
    <rule>.md           # optional; concatenated into the agent's rules file (CLAUDE.md, AGENTS.md, …)

The directory name under skills/ is the selectable skill name. description from the frontmatter is what the picker shows.

Usage

# List what this source provides
axskills list

# Pick skills/rules to remember for the current repo, then launch an agent
axskills select
axskills run claude

# Author against a local checkout instead of the published source
axskills list --source .

Adding a skill

Create skills/<name>/SKILL.md with name and description frontmatter, commit, and push. The next axskills fetch --refresh (or any run with --refresh) picks it up.