agent-skill-manager 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: agent-skill-manager
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: CLI tool for managing AI agent skills across multiple platforms
|
|
5
|
+
Author-email: ackness <ackness8@gmail.com>
|
|
6
|
+
Requires-Python: >=3.13
|
|
7
|
+
Requires-Dist: httpx>=0.28.1
|
|
8
|
+
Requires-Dist: inquirerpy>=0.3.4
|
|
9
|
+
Requires-Dist: loguru>=0.7.3
|
|
10
|
+
Requires-Dist: rich>=14.2.0
|
|
11
|
+
Description-Content-Type: text/markdown
|
|
12
|
+
|
|
13
|
+
# Agent Skill Manager
|
|
14
|
+
|
|
15
|
+
A comprehensive CLI tool for managing AI agent skills across multiple platforms. Download, deploy, update, and manage skills for AI coding assistants like Claude Code, Cursor, Windsurf, and more.
|
|
16
|
+
|
|
17
|
+
[](https://pypi.org/project/agent-skill-manager/)
|
|
18
|
+
[](https://www.python.org/downloads/)
|
|
19
|
+
[](https://opensource.org/licenses/MIT)
|
|
20
|
+
|
|
21
|
+
## Features
|
|
22
|
+
|
|
23
|
+
- 📥 **Download** skills from GitHub with metadata tracking
|
|
24
|
+
- 🚀 **Deploy** skills to multiple AI agents (global or project-level)
|
|
25
|
+
- 🔄 **Update** skills automatically from GitHub sources
|
|
26
|
+
- 🗑️ **Uninstall** with safe deletion (move to trash) or hard delete
|
|
27
|
+
- ♻️ **Restore** deleted skills from trash
|
|
28
|
+
- 📋 **List** all installed skills with version information
|
|
29
|
+
|
|
30
|
+
## Supported AI Agents
|
|
31
|
+
|
|
32
|
+
- Claude Code
|
|
33
|
+
- Cursor
|
|
34
|
+
- Windsurf
|
|
35
|
+
- OpenCode
|
|
36
|
+
- GitHub Copilot
|
|
37
|
+
- Goose
|
|
38
|
+
- Gemini CLI
|
|
39
|
+
- Roo Code
|
|
40
|
+
- Kilo Code
|
|
41
|
+
- Amp
|
|
42
|
+
- Codex
|
|
43
|
+
- Antigravity
|
|
44
|
+
- Clawdbot
|
|
45
|
+
- Droid
|
|
46
|
+
|
|
47
|
+
## Installation
|
|
48
|
+
|
|
49
|
+
### From PyPI
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# Using pip
|
|
53
|
+
pip install agent-skill-manager
|
|
54
|
+
|
|
55
|
+
# Using uv (recommended)
|
|
56
|
+
uv pip install agent-skill-manager
|
|
57
|
+
|
|
58
|
+
# Using pipx (isolated installation)
|
|
59
|
+
pipx install agent-skill-manager
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### From Source
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
git clone https://github.com/ackness/skill-manager.git
|
|
66
|
+
cd skill-manager
|
|
67
|
+
uv sync
|
|
68
|
+
uv pip install -e .
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Quick Start
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
# Install a skill from GitHub
|
|
75
|
+
sm install
|
|
76
|
+
|
|
77
|
+
# List installed skills
|
|
78
|
+
sm list
|
|
79
|
+
|
|
80
|
+
# Update all skills
|
|
81
|
+
sm update --all
|
|
82
|
+
|
|
83
|
+
# Deploy local skills to agents
|
|
84
|
+
sm deploy
|
|
85
|
+
|
|
86
|
+
# Uninstall a skill (safe delete)
|
|
87
|
+
sm uninstall
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Commands
|
|
91
|
+
|
|
92
|
+
| Command | Description |
|
|
93
|
+
|---------|-------------|
|
|
94
|
+
| `sm download` | Download a skill from GitHub |
|
|
95
|
+
| `sm deploy` | Deploy local skills to agents |
|
|
96
|
+
| `sm install` | Download and deploy in one step |
|
|
97
|
+
| `sm uninstall` | Remove skills (safe delete/hard delete) |
|
|
98
|
+
| `sm restore` | Restore deleted skills from trash |
|
|
99
|
+
| `sm update` | Update selected skills from GitHub |
|
|
100
|
+
| `sm update --all` | Update all GitHub-sourced skills |
|
|
101
|
+
| `sm list` | Show installed skills with versions |
|
|
102
|
+
|
|
103
|
+
## Usage Examples
|
|
104
|
+
|
|
105
|
+
### Install a skill from GitHub
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
sm install
|
|
109
|
+
# Enter URL: https://github.com/user/repo/tree/main/skills/example-skill
|
|
110
|
+
# Follow the prompts to save locally and deploy
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### Update all skills
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
sm update --all
|
|
117
|
+
# Automatically updates all skills installed from GitHub
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### List installed skills with versions
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
sm list
|
|
124
|
+
# Shows a table for each agent with:
|
|
125
|
+
# - Skill Name
|
|
126
|
+
# - Version/Updated timestamp
|
|
127
|
+
# - Source (GitHub/Local)
|
|
128
|
+
# - GitHub URL (for updatable skills)
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### Safe delete and restore
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
# Uninstall with safe delete (default)
|
|
135
|
+
sm uninstall
|
|
136
|
+
|
|
137
|
+
# Restore if needed
|
|
138
|
+
sm restore
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
## Version Tracking
|
|
142
|
+
|
|
143
|
+
The tool uses two methods for version identification:
|
|
144
|
+
|
|
145
|
+
1. **GitHub Metadata** (for installed skills)
|
|
146
|
+
- Tracks installation and update timestamps
|
|
147
|
+
- Stores repository information
|
|
148
|
+
- Enables automatic updates
|
|
149
|
+
|
|
150
|
+
2. **File Modification Time** (for local skills)
|
|
151
|
+
- Uses SKILL.md modification time as fallback
|
|
152
|
+
- For skills without metadata
|
|
153
|
+
|
|
154
|
+
## Directory Structure
|
|
155
|
+
|
|
156
|
+
### Global Installation
|
|
157
|
+
Skills are available to all projects:
|
|
158
|
+
```
|
|
159
|
+
~/.claude/skills/ # Claude Code
|
|
160
|
+
~/.cursor/skills/ # Cursor
|
|
161
|
+
~/.codeium/windsurf/skills/ # Windsurf
|
|
162
|
+
# ... other agents
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### Project Installation
|
|
166
|
+
Skills are only available in the current project:
|
|
167
|
+
```
|
|
168
|
+
project-root/
|
|
169
|
+
.claude/skills/
|
|
170
|
+
.cursor/skills/
|
|
171
|
+
# ... other agents
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
## Configuration
|
|
175
|
+
|
|
176
|
+
Each skill installed from GitHub includes metadata in `.skill_metadata.json`:
|
|
177
|
+
|
|
178
|
+
```json
|
|
179
|
+
{
|
|
180
|
+
"source": "github",
|
|
181
|
+
"github_url": "https://github.com/...",
|
|
182
|
+
"owner": "user",
|
|
183
|
+
"repo": "repo-name",
|
|
184
|
+
"branch": "main",
|
|
185
|
+
"path": "skills/skill-name",
|
|
186
|
+
"installed_at": "2026-01-20T14:30:52+00:00",
|
|
187
|
+
"updated_at": "2026-01-20T14:30:52+00:00"
|
|
188
|
+
}
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
## Development
|
|
192
|
+
|
|
193
|
+
### Adding Support for New Agents
|
|
194
|
+
|
|
195
|
+
Edit `src/skill_manager/agents.py` and add the agent configuration:
|
|
196
|
+
|
|
197
|
+
```python
|
|
198
|
+
"agent-id": {
|
|
199
|
+
"name": "Agent Name",
|
|
200
|
+
"project": ".agent/skills/",
|
|
201
|
+
"global": "~/.agent/skills/",
|
|
202
|
+
}
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
### Running Tests
|
|
206
|
+
|
|
207
|
+
```bash
|
|
208
|
+
uv run pytest
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
### Code Formatting
|
|
212
|
+
|
|
213
|
+
```bash
|
|
214
|
+
uv run ruff format .
|
|
215
|
+
uv run ruff check . --fix
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
## Contributing
|
|
219
|
+
|
|
220
|
+
Contributions are welcome! Please feel free to submit a Pull Request.
|
|
221
|
+
|
|
222
|
+
1. Fork the repository
|
|
223
|
+
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
|
|
224
|
+
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
|
|
225
|
+
4. Push to the branch (`git push origin feature/amazing-feature`)
|
|
226
|
+
5. Open a Pull Request
|
|
227
|
+
|
|
228
|
+
## Related Projects
|
|
229
|
+
|
|
230
|
+
- [Agent Skills Specification](https://agentskills.io/specification)
|
|
231
|
+
- [Agent Skills Registry](https://agentskills.io)
|
|
232
|
+
|
|
233
|
+
## License
|
|
234
|
+
|
|
235
|
+
MIT License - See [LICENSE](LICENSE) file for details
|
|
236
|
+
|
|
237
|
+
## Author
|
|
238
|
+
|
|
239
|
+
**ackness** - [ackness8@gmail.com](mailto:ackness8@gmail.com)
|
|
240
|
+
|
|
241
|
+
## Acknowledgments
|
|
242
|
+
|
|
243
|
+
- Built following the [Agent Skills specification](https://agentskills.io/specification)
|
|
244
|
+
- Supports all major AI coding assistants
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
agent_skill_manager-0.1.0.dist-info/METADATA,sha256=MFWGu8q0dBnVmNQLMSZ2m28g8qVxZTVkDUOyvtLNrzA,5457
|
|
2
|
+
agent_skill_manager-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
|
|
3
|
+
agent_skill_manager-0.1.0.dist-info/entry_points.txt,sha256=ac3L07OC98p1llk259d9PUhDp-cl3ifV2nmYHGb3WO8,85
|
|
4
|
+
agent_skill_manager-0.1.0.dist-info/RECORD,,
|