Back to search
askill
SkillGitHub
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
Markdown
[](/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
- # askill
- 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`).
- ## Architecture
- ```text
- +------------------------------+
- | Central Hub: ~/.agents/skills|
- +--------------+---------------+
- |
- +------------------+-------+-------+------------------+
- v v v v
- Antigravity Claude Code Codex Pi
- (~/.gemini) (~/.claude) (~/.codex) (~/.pi/agent)
- ```
- - Every skill lives once inside `~/.agents/skills/<skill-name>/`.
- - Per-agent skill folders receive symbolic links managed by `askill sync`.
- - Additional agent paths can be added via `~/.config/askill/config.json` (`ASKILL_CONFIG`).
- ## Installation
- Using [`uv`](https://docs.astral.sh/uv/):
- ```bash
- 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).
- ## Usage
- ```bash
- # Show skill link status matrix across agents
- askill status
- # Install skills from a GitHub repo, Git URL, or local directory
- askill install zjy-dev/skills
- askill install zjy-dev/skills --skill organize-projects --replace
- # Sync Hub symlinks to all configured agents (or a single agent)
- askill sync
- askill sync --agent claude
- # Move an unmanaged local skill folder into the Hub and link back
- askill adopt ./path/to/my-skill
- # Remove skills from Hub and unlink everywhere
- askill remove my-skill
- # Check Hub and agent directories for broken links or missing SKILL.md
- askill doctor
- ```
- ## Configuration (`~/.config/askill/config.json`)
- Optional JSON file to customize the Hub path or register extra agent skill directories:
- ```json
- {
- "hub_dir": "~/.agents/skills",
- "extra_agents": {
- "custom-ide": "~/.custom-ide/skills"
- },
- "vendor_dirs": {
- "vendor_builtin": "~/.custom-ide/builtin_skills"
- }
- }
- ```
- ## Companion Skill
- 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 inFree to use. If it’s helped, pass it on.