Skip to content
Back to search

askill

Unified Hub-and-Spoke CLI for managing Agent Skills across AI coding agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zjy-dev--askill/badge.svg)](/listings/zjy-dev--askill)

HTML

<a href="/listings/zjy-dev--askill"><img src="/api/listings/zjy-dev--askill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Using [`uv`](https://docs.astral.sh/uv/):

uv tool install git+https://github.com/zjy-dev/askill.git

Or run `src/askill/cli.py` directly with Python 3.9+ (zero third-party dependencies).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 74 lines
  1. # askill
  2. Unified Hub-and-Spoke CLI for managing and synchronizing [Agent Skills](https://agentskills.io) across multiple AI coding agents from a single source of truth (`~/.agents/skills`).
  3. ## Architecture
  4. ```text
  5. +------------------------------+
  6. | Central Hub: ~/.agents/skills|
  7. +--------------+---------------+
  8. |
  9. +------------------+-------+-------+------------------+
  10. v v v v
  11. Antigravity Claude Code Codex Pi
  12. (~/.gemini) (~/.claude) (~/.codex) (~/.pi/agent)
  13. ```
  14. - Every skill lives once inside `~/.agents/skills/<skill-name>/`.
  15. - Per-agent skill folders receive symbolic links managed by `askill sync`.
  16. - Additional agent paths can be added via `~/.config/askill/config.json` (`ASKILL_CONFIG`).
  17. ## Installation
  18. Using [`uv`](https://docs.astral.sh/uv/):
  19. ```bash
  20. uv tool install git+https://github.com/zjy-dev/askill.git
  21. ```
  22. Or run `src/askill/cli.py` directly with Python 3.9+ (zero third-party dependencies).
  23. ## Usage
  24. ```bash
  25. # Show skill link status matrix across agents
  26. askill status
  27. # Install skills from a GitHub repo, Git URL, or local directory
  28. askill install zjy-dev/skills
  29. askill install zjy-dev/skills --skill organize-projects --replace
  30. # Sync Hub symlinks to all configured agents (or a single agent)
  31. askill sync
  32. askill sync --agent claude
  33. # Move an unmanaged local skill folder into the Hub and link back
  34. askill adopt ./path/to/my-skill
  35. # Remove skills from Hub and unlink everywhere
  36. askill remove my-skill
  37. # Check Hub and agent directories for broken links or missing SKILL.md
  38. askill doctor
  39. ```
  40. ## Configuration (`~/.config/askill/config.json`)
  41. Optional JSON file to customize the Hub path or register extra agent skill directories:
  42. ```json
  43. {
  44. "hub_dir": "~/.agents/skills",
  45. "extra_agents": {
  46. "custom-ide": "~/.custom-ide/skills"
  47. },
  48. "vendor_dirs": {
  49. "vendor_builtin": "~/.custom-ide/builtin_skills"
  50. }
  51. }
  52. ```
  53. ## Companion Skill
  54. This repository includes `skills/agent-skills/SKILL.md` so coding agents understand and follow the `askill` Hub-and-Spoke workflow.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.