AgentSkill 🛠️
Universal AI Skill Manager — Create, manage, and share coding rules for AI assistants like GitHub Copilot, Claude Code, and Cursor.
🎯 What is AgentSkill?
AgentSkill is a CLI tool that helps you create and manage skills (coding rules and best practices) that AI coding assistants follow when helping you write code.
The Problem
- You want AI to follow your coding standards consistently
- You have to repeat the same instructions in every project
- Different AI tools (Copilot, Claude, Cursor) need different file formats
- Sharing coding standards with your team is difficult
The Solution
AgentSkill lets you:
- ✅ Create skills once, use everywhere
- ✅ Install skills in any project with one command
- ✅ Auto-detect and support multiple AI tools
- ✅ Share skills with your team via export/import
- ✅ Update skills across all projects instantly
🚀 Installation
pip install agentskill-cli
After installation, both agentskill and ask (short) commands are available.
📖 Use Cases
1. Enforce Coding Standards
Create a skill to enforce your team's coding standards:
agentskill create python-standards -l python
Edit the skill to add your rules:
## Python Standards
- Use type hints for all function parameters and return values
- Use `pathlib` instead of `os.path`
- Prefer f-strings over .format()
- All functions must have docstrings
- Maximum line length: 88 characters (Black formatter)
2. Framework-Specific Rules
Create skills for specific frameworks with built-in templates:
# React component rules
agentskill create react-rules -l javascript -f react
# Django API rules
agentskill create django-api -l python -f django
# Flutter widget rules
agentskill create flutter-app -l dart -f flutter
3. Project-Specific Instructions
Create skills for specific project requirements:
agentskill create myproject-rules
Add project-specific rules:
## MyProject Rules
- Use PostgreSQL for all database operations
- All API endpoints must be versioned (/api/v1/...)
- Use Redis for caching
- JWT tokens for authentication
- Follow company naming conventions
4. Team Collaboration
Share skills across your team:
# Export skill
agentskill export react-rules
# Creates: react-rules.skill.zip
# Team member imports
agentskill import react-rules.skill.zip
5. Multi-Project Consistency
Install the same skill in multiple projects:
cd ~/project-1
agentskill install python-standards
cd ~/project-2
agentskill install python-standards
cd ~/project-3
agentskill install python-standards
Update skill once, sync everywhere:
agentskill edit python-standards # Make changes
agentskill update python-standards # Sync to all projects
📋 Quick Start
Step 1: Create a Skill
agentskill create my-rules -l python -f django
Step 2: Edit the Skill (optional)
agentskill edit my-rules
Step 3: Install in Your Project
cd /path/to/your/project
agentskill install my-rules
Step 4: Done!
AI assistants will now follow your rules when working in this project.
🔧 Commands
| Command | Short | Description |
|---|---|---|
agentskill create <name> |
ask create |
Create new skill |
agentskill install <name> |
ask install |
Install skill in current project |
agentskill list |
ask list |
Show all skills |
agentskill show <name> |
ask show |
View skill details |
agentskill edit <name> |
ask edit |
Open skill in editor |
agentskill update <name> |
ask update |
Sync skill to all projects |
agentskill delete <name> |
ask delete |
Remove skill |
agentskill export <name> |
ask export |
Export skill as zip |
agentskill import <zip> |
ask import |
Import skill from zip |
agentskill init |
ask init |
Create AI folders in project |
agentskill where |
ask where |
Show skills storage location |
🎨 Creating Skills
Basic Skill
agentskill create my-rules
With Language & Framework Templates
# Python + Django
agentskill create django-api -l python -f django
# JavaScript + React
agentskill create react-component -l javascript -f react
# TypeScript + Next.js
agentskill create nextjs-app -l javascript -f nextjs
# Dart + Flutter
agentskill create flutter-widget -l dart -f flutter
# Go + Gin
agentskill create go-api -l go -f gin
# Rust + Actix
agentskill create rust-api -l rust -f actix
Supported Templates
| Language | Frameworks |
|---|---|
| Python | django, fastapi, flask |
| JavaScript/TypeScript | react, nextjs, node |
| Dart | flutter |
| Go | gin, fiber |
| Rust | actix, axum |
📁 Skill Structure
my-skill/
├── SKILL.md # Main instructions (loaded by AI)
├── skill.yaml # Metadata (language, framework, version)
├── instructions.md # Legacy format for compatibility
├── scripts/ # Helper scripts
├── references/ # Additional documentation
│ └── examples.md # Code examples
└── assets/ # Templates, boilerplate code
SKILL.md Format
---
name: my-skill
description: 'Rules for Python Django development'
---
# My Skill
## When to Use
- Working on Django projects
- Building REST APIs
## Rules
- Use class-based views for complex logic
- Always use Django ORM
- Keep business logic in services
## Examples
Check `./references/examples.md` for code examples.
🔌 Supported AI Tools
| Tool | Folder | Auto-Detected |
|---|---|---|
| GitHub Copilot | .github/skills/ |
✅ |
| Claude Code | .claude/skills/ |
✅ |
| Cursor | .cursor/skills/ |
✅ |
Install for Specific Tool
# GitHub Copilot only
agentskill install my-skill -t copilot
# Claude only
agentskill install my-skill -t claude
# Cursor only
agentskill install my-skill -t cursor
# All tools
agentskill install my-skill -t all
🏗️ How It Works
┌─────────────────────────────────────────────────────────────────┐
│ AgentSkill Flow │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 1. CREATE 2. STORE │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ agentskill │ │ ~/.agentskill/ │ │
│ │ create my-skill │ ──────▶ │ skills/ │ │
│ └─────────────────┘ │ my-skill/ │ │
│ │ SKILL.md │ │
│ └─────────────────┘ │
│ │ │
│ 3. INSTALL │ │
│ ┌─────────────────┐ │ │
│ │ agentskill │ ▼ │
│ │ install my-skill│ ┌─────────────────┐ │
│ └─────────────────┘ │ your-project/ │ │
│ │ .github/ │ │
│ COPY ───────────────▶│ skills/ │ │
│ │ my-skill/ │ │
│ └─────────────────┘ │
│ │ │
│ 4. AI READS ▼ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ GitHub Copilot │◀────────│ Follows your │ │
│ │ Claude Code │ │ coding rules! │ │
│ │ Cursor │ └─────────────────┘ │
│ └─────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
💡 Tips & Best Practices
Writing Effective Skills
- Be Specific: Use clear, actionable rules
- Add Examples: Include code examples in
references/examples.md - Keep It Focused: One skill per domain/framework
- Use Trigger Words: AI finds skills by matching keywords in descriptions
Skill Organization
# Recommended skill structure
agentskill create company-standards # General company rules
agentskill create python-backend # Python backend rules
agentskill create react-frontend # React frontend rules
agentskill create api-design # API design rules
Team Workflow
# 1. Create shared skills repository
mkdir team-skills && cd team-skills
git init
# 2. Export skills
agentskill export python-standards
agentskill export react-rules
# 3. Commit and push
git add .
git commit -m "Add team skills"
git push
# 4. Team members import
git clone <repo>
agentskill import python-standards.skill.zip
agentskill import react-rules.skill.zip
🔄 Updating Skills
Edit and Update
# Edit the skill
agentskill edit my-skill
# Update in all projects where it's installed
agentskill update my-skill
Version Tracking
Skills have version numbers in skill.yaml:
name: my-skill
version: 1.0
🗑️ Managing Skills
Delete a Skill
agentskill delete my-skill
# Force delete (no confirmation)
agentskill delete my-skill -f
View Storage Location
agentskill where
# Output: ~/.agentskill/skills/
📦 Sharing Skills
Export
agentskill export my-skill
# Creates: my-skill.skill.zip
Import
agentskill import my-skill.skill.zip
📄 License
This project is licensed under the MIT License.
🙏 Acknowledgments
- Inspired by the need for consistent AI-assisted coding
- Built with Typer for the CLI
- Supports GitHub Copilot, Claude Code, and Cursor
📧 Author
- Parth Kher
Made with ❤️ for developers who want AI to follow their rules.
Metadata
Release files for agentskill-cli 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agentskill_cli-1.0.1.tar.gz | 13.2 kB | Without provenance | Details for agentskill_cli-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentskill_cli-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for agentskill_cli-1.0.1-py3-none-any.whl |
Total release size: 23.9 kB
Release files / agentskill_cli-1.0.1.tar.gz
| Download URL | agentskill_cli-1.0.1.tar.gz |
|---|---|
| Size | 13.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
60221d0610bf532198a4edd08b542e443d78f4be3966d0403deef647a8e1d196
|
|
BLAKE2b-256 checksum How to use checksums |
545816e7f94ea025f7e8b09d4059379b861b6307bb340c759c6bc660ccfb7962
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Release files / agentskill_cli-1.0.1-py3-none-any.whl
| Download URL | agentskill_cli-1.0.1-py3-none-any.whl |
|---|---|
| Size | 10.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
82ec8c6d260d44ca3d2bd09dc76cdf4f2da126f3ed19fc8d76da7e63eb18cfaf
|
|
BLAKE2b-256 checksum How to use checksums |
a0eb0c5700b67a4246bb59c4dcc2e9cdddd5246eb3b94db46c6fad0f96366d5c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Security for agentskill-cli 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.