agent-skill-manager 0.1.1__tar.gz → 0.1.3__tar.gz

{agent_skill_manager-0.1.1 → agent_skill_manager-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-skill-manager
-Version: 0.1.1
+Version: 0.1.3
 Summary: CLI tool for managing AI agent skills across multiple platforms
 Project-URL: Homepage, https://github.com/ackness/skill-manager
 Project-URL: Repository, https://github.com/ackness/skill-manager
@@ -25,6 +25,8 @@ Description-Content-Type: text/markdown
 
 # Agent Skill Manager
 
+ALL codes are written by Claude Code.
+
 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.
 
 [![PyPI version](https://badge.fury.io/py/agent-skill-manager.svg)](https://pypi.org/project/agent-skill-manager/)
@@ -59,40 +61,50 @@ A comprehensive CLI tool for managing AI agent skills across multiple platforms.
 
 ## Installation
 
-### Quick Run with uvx (No Installation Required)
+### Recommended: Install with uv tool
 
-Run directly without installing (recommended for trying it out):
+The best way to install is using `uv tool`:
 
 ```bash
-# Show help (default command)
+# Install from PyPI
+uv tool install agent-skill-manager
+
+# Verify installation
+sm --version
+
+# Start using
+sm install
+```
+
+**Why uv tool?**
+- Isolated environment (no package conflicts)
+- Easy updates: `uv tool upgrade agent-skill-manager`
+- Clean uninstall: `uv tool uninstall agent-skill-manager`
+- Works across all projects
+
+### Alternative: Run Without Installing
+
+For one-time use or testing:
+
+```bash
+# Run directly with uvx (no installation needed)
 uvx agent-skill-manager
 
-# Use sm command for specific operations
+# Or run specific commands
 uvx --from agent-skill-manager sm install
 uvx --from agent-skill-manager sm list
-uvx --from agent-skill-manager sm update --all
-
-# Or create an alias for convenience
-alias sm="uvx --from agent-skill-manager sm"
-sm install  # Now you can use it like the installed version
 ```
 
-### Permanent Installation
+### Other Installation Methods
 
 ```bash
-# Using uv (recommended)
-uv tool install agent-skill-manager
-
 # Using pip
 pip install agent-skill-manager
 
-# Using pipx (isolated installation)
+# Using pipx (isolated like uv tool)
 pipx install agent-skill-manager
-```
 
-### From Source
-
-```bash
+# From source (for development)
 git clone https://github.com/ackness/skill-manager.git
 cd skill-manager
 uv sync
@@ -135,6 +147,7 @@ sm uninstall       # Uninstall a skill (safe delete)
 | `sm update` | Update selected skills from GitHub |
 | `sm update --all` | Update all GitHub-sourced skills |
 | `sm list` | Show installed skills with versions |
+| `sm --version` / `sm -v` | Show version information |
 
 ## Usage Examples
 

{agent_skill_manager-0.1.1 → agent_skill_manager-0.1.3}/README.md

@@ -1,5 +1,7 @@
 # Agent Skill Manager
 
+ALL codes are written by Claude Code.
+
 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.
 
 [![PyPI version](https://badge.fury.io/py/agent-skill-manager.svg)](https://pypi.org/project/agent-skill-manager/)
@@ -34,40 +36,50 @@ A comprehensive CLI tool for managing AI agent skills across multiple platforms.
 
 ## Installation
 
-### Quick Run with uvx (No Installation Required)
+### Recommended: Install with uv tool
 
-Run directly without installing (recommended for trying it out):
+The best way to install is using `uv tool`:
 
 ```bash
-# Show help (default command)
+# Install from PyPI
+uv tool install agent-skill-manager
+
+# Verify installation
+sm --version
+
+# Start using
+sm install
+```
+
+**Why uv tool?**
+- Isolated environment (no package conflicts)
+- Easy updates: `uv tool upgrade agent-skill-manager`
+- Clean uninstall: `uv tool uninstall agent-skill-manager`
+- Works across all projects
+
+### Alternative: Run Without Installing
+
+For one-time use or testing:
+
+```bash
+# Run directly with uvx (no installation needed)
 uvx agent-skill-manager
 
-# Use sm command for specific operations
+# Or run specific commands
 uvx --from agent-skill-manager sm install
 uvx --from agent-skill-manager sm list
-uvx --from agent-skill-manager sm update --all
-
-# Or create an alias for convenience
-alias sm="uvx --from agent-skill-manager sm"
-sm install  # Now you can use it like the installed version
 ```
 
-### Permanent Installation
+### Other Installation Methods
 
 ```bash
-# Using uv (recommended)
-uv tool install agent-skill-manager
-
 # Using pip
 pip install agent-skill-manager
 
-# Using pipx (isolated installation)
+# Using pipx (isolated like uv tool)
 pipx install agent-skill-manager
-```
 
-### From Source
-
-```bash
+# From source (for development)
 git clone https://github.com/ackness/skill-manager.git
 cd skill-manager
 uv sync
@@ -110,6 +122,7 @@ sm uninstall       # Uninstall a skill (safe delete)
 | `sm update` | Update selected skills from GitHub |
 | `sm update --all` | Update all GitHub-sourced skills |
 | `sm list` | Show installed skills with versions |
+| `sm --version` / `sm -v` | Show version information |
 
 ## Usage Examples
 

{agent_skill_manager-0.1.1 → agent_skill_manager-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-skill-manager"
-version = "0.1.1"
+version = "0.1.3"
 description = "CLI tool for managing AI agent skills across multiple platforms"
 authors = [
     { name = "ackness", email = "ackness8@gmail.com" }

{agent_skill_manager-0.1.1 → agent_skill_manager-0.1.3}/src/skill_manager/__init__.py

@@ -5,7 +5,7 @@ This package provides functionality to download, deploy, and manage
 skills across different AI agent platforms.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.3"
 
 from .agents import AGENTS, detect_existing_agents, get_agent_name, get_agent_path
 from .deployment import (

{agent_skill_manager-0.1.1 → agent_skill_manager-0.1.3}/src/skill_manager/cli.py

@@ -27,6 +27,7 @@ from rich.panel import Panel
 from rich.progress import Progress, SpinnerColumn, TextColumn
 from rich.table import Table
 
+from . import __version__
 from .agents import AGENTS, detect_existing_agents, get_agent_name, get_agent_path
 from .deployment import (
     deploy_multiple_skills,
@@ -41,7 +42,6 @@ from .metadata import (
     save_skill_metadata,
 )
 from .removal import (
-    clean_trash,
     hard_delete_skill,
     list_installed_skills,
     list_trashed_skills,
@@ -700,7 +700,7 @@ def cmd_uninstall() -> int:
             Panel.fit(
                 f"[bold green]✓ Uninstallation successful![/bold green]\n\n"
                 f"Removed {success_count} skills\n"
-                + (f"[dim]Skills moved to trash and can be restored with 'sm restore'[/dim]" if deletion_type == "soft" else ""),
+                + ("[dim]Skills moved to trash and can be restored with 'sm restore'[/dim]" if deletion_type == "soft" else ""),
                 border_style="green",
             )
         )
@@ -1129,10 +1129,15 @@ def main() -> int:
     Returns:
         Exit code
     """
+    # Handle version flag
+    if len(sys.argv) > 1 and sys.argv[1] in ("--version", "-v", "version"):
+        console.print(f"[cyan]agent-skill-manager[/cyan] version [bold]{__version__}[/bold]")
+        return 0
+
     if len(sys.argv) < 2:
         console.print(
             Panel.fit(
-                "[bold cyan]Skill Manager[/bold cyan]\n\n"
+                f"[bold cyan]Skill Manager[/bold cyan] [dim]v{__version__}[/dim]\n\n"
                 "Usage:\n"
                 "  sm download      - Download a skill from GitHub\n"
                 "  sm deploy        - Deploy local skills to agents\n"
@@ -1141,7 +1146,8 @@ def main() -> int:
                 "  sm restore       - Restore deleted skills from trash\n"
                 "  sm update        - Update skills from GitHub\n"
                 "  sm update --all  - Update all skills from GitHub\n"
-                "  sm list          - List installed skills and versions\n\n"
+                "  sm list          - List installed skills and versions\n"
+                "  sm --version     - Show version information\n\n"
                 "[dim]Note: You can also use 'skill-manager' instead of 'sm'[/dim]",
                 border_style="cyan",
             )
@@ -1167,7 +1173,7 @@ def main() -> int:
             return cmd_list()
         else:
             console.print(f"[red]Unknown command: {command}[/red]")
-            console.print("Available commands: download, deploy, install, uninstall, restore, update, list")
+            console.print("Available commands: download, deploy, install, uninstall, restore, update, list, --version")
             return 1
     except KeyboardInterrupt:
         console.print("\n[yellow]Cancelled[/yellow]")

{agent_skill_manager-0.1.1 → agent_skill_manager-0.1.3}/src/skill_manager/deployment.py

@@ -13,7 +13,6 @@ from .github import download_skill_from_github
 from .metadata import (
     list_updatable_skills,
     read_skill_metadata,
-    save_skill_metadata,
     update_skill_metadata,
 )
 

{agent_skill_manager-0.1.1 → agent_skill_manager-0.1.3}/src/skill_manager/metadata.py

@@ -8,7 +8,6 @@ import json
 from datetime import UTC, datetime
 from pathlib import Path
 
-
 METADATA_FILENAME = ".skill_metadata.json"
 
 

{agent_skill_manager-0.1.1 → agent_skill_manager-0.1.3}/uv.lock

@@ -4,7 +4,7 @@ requires-python = ">=3.13"
 
 [[package]]
 name = "agent-skill-manager"
-version = "0.1.0"
+version = "0.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

agent_skill_manager-0.1.1/Dockerfile

@@ -1,21 +0,0 @@
-FROM python:3.13-slim-trixie
-
-COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
-
-ENV UV_CACHE_DIR=/root/.cache/uv \
-    UV_LINK_MODE=copy \
-    UV_COMPILE_BYTECODE=1
-
-WORKDIR /app
-
-RUN --mount=type=cache,target=${UV_CACHE_DIR} \
-    --mount=type=bind,source=uv.lock,target=uv.lock \
-    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
-    uv sync --locked --no-install-project
-
-COPY . .
-
-RUN --mount=type=cache,target=${UV_CACHE_DIR} \
-    uv sync --locked
-
-CMD ["uv", "run", "python", "main.py"]

agent_skill_manager-0.1.1/SKILL.md

@@ -1,378 +0,0 @@
----
-name: skill-manager
-description: Manage AI agent skills - download from GitHub, deploy to multiple agents, update, uninstall with safe deletion, and track versions. Use when users want to install, manage, or update skills for AI coding assistants like Claude Code, Cursor, Windsurf, etc.
-license: MIT
-compatibility: Requires Python 3.13+, uv or rye package manager, internet access for GitHub downloads
-metadata:
-  author: ackness
-  version: "0.1.0"
-  repository: https://github.com/ackness/skill-manager
-  pypi: agent-skill-manager
-  platforms:
-    - windows
-    - linux
-    - macos
-allowed-tools: Bash(uv:*) Bash(git:*) Read Write
----
-
-# Skill Manager
-
-A comprehensive CLI tool for managing AI agent skills across multiple platforms. Supports downloading skills from GitHub, deploying to various AI agents, version tracking, safe deletion with recovery, and automatic updates.
-
-## Supported AI Agents
-
-- Claude Code
-- Cursor
-- Windsurf
-- OpenCode
-- Copilot
-- Goose
-- Gemini CLI
-- Roo Code
-- Kilo Code
-- Amp
-- Codex
-- Antigravity
-- Clawdbot
-- Droid
-
-## Installation
-
-### Quick Run (No Installation Required)
-
-Run directly with uvx without installing (perfect for one-time use or testing):
-
-```bash
-# Show help menu
-uvx agent-skill-manager
-
-# Run specific commands
-uvx --from agent-skill-manager sm install
-uvx --from agent-skill-manager sm list
-uvx --from agent-skill-manager sm update --all
-
-# Create a shell alias for convenience
-alias sm="uvx --from agent-skill-manager sm"
-# Now use it like: sm install, sm list, etc.
-```
-
-**Benefits of uvx:**
-- No installation needed
-- Always uses the latest version from PyPI
-- Isolated environment (no conflicts)
-- Perfect for CI/CD or automated scripts
-
-### Permanent Installation
-
-```bash
-# Install from PyPI with uv (recommended)
-uv tool install agent-skill-manager
-
-# Install from PyPI with pip
-pip install agent-skill-manager
-
-# Or install from source
-git clone https://github.com/ackness/skill-manager.git
-cd skill-manager
-uv sync
-uv pip install -e .
-```
-
-After installation, the `sm` command will be available globally.
-
-## Commands Overview
-
-### Download Skills
-```bash
-sm download
-```
-Downloads a skill from GitHub to local storage. Saves metadata for version tracking and future updates.
-
-**When to use:** When you want to save a skill locally without deploying it yet.
-
-**Interactive prompts:**
-- GitHub URL of the skill
-- Whether to save to local skills/ directory
-- Category for organization (optional)
-
-### Deploy Skills
-```bash
-sm deploy
-```
-Deploys skills from your local `skills/` directory to selected AI agents.
-
-**When to use:** When you have local skills ready to deploy to agents.
-
-**Interactive prompts:**
-- Deployment location (global/project)
-- Target agents
-- Skills to deploy
-
-### Install Skills
-```bash
-sm install
-```
-Combined operation: downloads from GitHub and deploys to agents in one step.
-
-**When to use:** When you want to quickly install a skill from GitHub to your agents.
-
-**Interactive prompts:**
-- GitHub URL
-- Whether to save locally
-- Category (if saving locally)
-- Whether to deploy
-- Target agents and deployment location
-
-### Update Skills
-```bash
-# Update selected skills
-sm update
-
-# Update all skills with GitHub metadata
-sm update --all
-```
-Updates skills from their GitHub sources. Only works for skills installed via `sm install` or with saved metadata.
-
-**When to use:** When you want to get the latest version of installed skills.
-
-**Features:**
-- Automatic backup before update
-- Rollback on failure
-- Updates metadata timestamps
-- Shows version information
-
-### Uninstall Skills
-```bash
-sm uninstall
-```
-Removes skills from agents with two deletion modes:
-- **Safe delete (default):** Moves to `.trash` with timestamp for recovery
-- **Hard delete:** Permanent removal
-
-**When to use:** When you want to remove skills from agents.
-
-**Interactive prompts:**
-- Deployment type
-- Target agents
-- Skills to remove
-- Deletion type (safe/hard)
-
-### Restore Skills
-```bash
-sm restore
-```
-Restores previously deleted skills from trash.
-
-**When to use:** When you accidentally deleted a skill or want to recover it.
-
-**Interactive prompts:**
-- Deployment type
-- Target agents
-- Skills to restore (shows deletion timestamp)
-
-### List Skills
-```bash
-sm list
-```
-Shows all installed skills with version information across agents.
-
-**When to use:** When you want to see what skills are installed and their versions.
-
-**Displays:**
-- Skill names
-- Version/update timestamp
-- Source (GitHub/Local)
-- GitHub URL (for updatable skills)
-- Organized by agent
-
-## Directory Structure
-
-### Global Installation
-Skills installed globally are available to all projects:
-```
-~/.claude/skills/           # Claude Code
-~/.cursor/skills/           # Cursor
-~/.codeium/windsurf/skills/ # Windsurf
-# ... other agents
-```
-
-### Project Installation
-Skills installed at project level are only available in that project:
-```
-project-root/
-  .claude/skills/
-  .cursor/skills/
-  # ... other agents
-```
-
-### Metadata Storage
-Each skill installed from GitHub includes metadata:
-```
-skill-name/
-  SKILL.md
-  .skill_metadata.json    # Contains GitHub source, timestamps
-  # ... skill files
-```
-
-### Trash Storage
-Safely deleted skills are stored with timestamps:
-```
-~/.claude/
-  skills/                 # Active skills
-  .trash/                 # Deleted skills
-    20260120_143052/      # Timestamp directory
-      skill-name/
-        .trash_metadata   # Deletion info
-        # ... skill files
-```
-
-## Version Tracking
-
-The tool uses two methods for version identification:
-
-1. **GitHub Metadata** (for installed skills):
-   - Tracks installation and update timestamps
-   - Stores repository information
-   - Enables automatic updates
-   - Format: ISO 8601 timestamp
-
-2. **File Modification Time** (for local skills):
-   - Uses SKILL.md modification time
-   - Fallback for skills without metadata
-   - Format: YYYY-MM-DD HH:MM:SS
-
-## Examples
-
-### Install a skill from GitHub
-
-With uvx (no installation needed):
-```bash
-uvx --from agent-skill-manager sm install
-# Enter URL: https://github.com/user/repo/tree/main/skills/example-skill
-# Save locally? Yes
-# Category: productivity
-# Deploy? Yes
-# Select agents: Claude Code, Cursor
-# Deployment: Global
-```
-
-Or with installed version:
-```bash
-sm install
-# Follow the same prompts as above
-```
-
-### Update all skills
-```bash
-sm update --all
-# Selects all agents with GitHub-sourced skills
-# Downloads latest versions
-# Updates metadata timestamps
-```
-
-### List installed skills
-```bash
-sm list
-# Shows table for each agent:
-# Skill Name | Version/Updated | Source | GitHub URL
-```
-
-### Uninstall with safe delete
-```bash
-sm uninstall
-# Select skills to remove
-# Choose "Safe delete"
-# Skills moved to .trash with timestamp
-# Can be restored later with sm restore
-```
-
-## Best Practices
-
-1. **Use safe delete by default** - You can always restore if needed
-2. **Update regularly** - Run `sm update --all` periodically for bug fixes and improvements
-3. **Save skills locally** - Keep a local copy in `skills/` for backup
-4. **Organize with categories** - Use categories when saving locally for better organization
-5. **Check versions** - Use `sm list` to see what's installed and outdated
-
-## Troubleshooting
-
-### Command not found: sm
-Reinstall the package:
-```bash
-uv pip install -e .
-```
-
-### GitHub download fails
-- Check internet connection
-- Verify the GitHub URL is correct
-- Ensure the URL points to a directory, not a file
-- Check if the repository is public
-
-### Skill not showing in agent
-- Verify the agent is running
-- Check deployment location (global vs project)
-- Ensure the skill has a valid SKILL.md file
-- Restart the agent if necessary
-
-### Update fails
-- The tool automatically restores from backup
-- Check if the GitHub repository still exists
-- Verify internet connection
-- Try reinstalling: `sm uninstall` then `sm install`
-
-## Technical Details
-
-### Metadata Format
-```json
-{
-  "source": "github",
-  "github_url": "https://github.com/...",
-  "owner": "user",
-  "repo": "repo-name",
-  "branch": "main",
-  "path": "skills/skill-name",
-  "installed_at": "2026-01-20T14:30:52.123456+00:00",
-  "updated_at": "2026-01-20T14:30:52.123456+00:00"
-}
-```
-
-### Agent Configuration
-Each agent has defined paths for:
-- **project**: Skills directory within current project
-- **global**: User-wide skills directory
-- See `src/skill_manager/agents.py` for complete mapping
-
-### Update Process
-1. Read skill metadata to get GitHub source
-2. Download updated version to temporary location
-3. Create backup of current version
-4. Remove current version
-5. Move updated version to skill location
-6. Update metadata timestamp
-7. Clean up temporary files
-8. On failure: restore from backup
-
-## Development
-
-To add support for a new AI agent:
-
-1. Edit `src/skill_manager/agents.py`
-2. Add agent configuration:
-```python
-"agent-id": {
-    "name": "Agent Name",
-    "project": ".agent/skills/",
-    "global": "~/.agent/skills/",
-}
-```
-3. Test with `sm list` to verify detection
-
-## Related Resources
-
-- Agent Skills Specification: https://agentskills.io/specification
-- Report Issues: https://github.com/ackness/skill-manager/issues
-- Skill Registry: https://agentskills.io
-
-## License
-
-MIT License - See LICENSE file for details

agent_skill_manager-0.1.1/main.py

@@ -1,9 +0,0 @@
-from loguru import logger
-
-
-def main():
-    logger.info("Hello from main!")
-
-
-if __name__ == "__main__":
-    main()