agent-skill-kit 0.1.1__py3-none-any.whl

agent_skill_kit-0.1.1.dist-info/METADATA

@@ -0,0 +1,355 @@
+Metadata-Version: 2.4
+Name: agent-skill-kit
+Version: 0.1.1
+Summary: Centralized skills repository and CLI toolkit for AI agents
+Author: Nava
+License-Expression: MIT
+Keywords: agents,ai,claude,cli,codex,gemini,skills
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Agent Skill Kit (ASK)
+
+![Agent Skill Kit Banner](assets/banner.png)
+
+**Agent Skill Kit (ASK)** is a CLI toolkit for managing, distributing, and syncing skills across multiple AI agents. It serves as a unified "package manager" for your AI's capabilities, allowing you to define a skill once and deploy it to **Gemini, Claude, Codex, Antigravity, Cursor**, and more.
+
+## 🧠 Why Agent Skill Kit?
+
+Managing instructions for multiple AI agents is tedious. You often have to:
+*   Copy `.cursorrules` to `.codex.md`.
+*   Manually sync `~/instructions.md` with project-specific prompts.
+*   Format skills differently for Gemini (`SKILL.md`) vs Claude (Slash Commands).
+
+**ASK** solves this by treating skills as **reusable packages**.
+1. **Define Once**: Write a skill in a standard format.
+2. **Deploy Anywhere**: ASK transforms and copies the skill to the correct location and format for each agent.
+3. **Sync**: Keep all your agents updated with a single command.
+
+## 🚀 Features
+
+- **Multi-Agent Support**: Native support for Gemini, Claude Code, OpenAI Codex, Antigravity, and Cursor.
+- **Dynamic Discovery**: Automatically discovers available agents in the `agents/` directory.
+- **Safe Copy**: Strictly adheres to "Do Not Overwrite". Prompts for a new name if a skill conflicts.
+- **Local & Global**: Choose between **Project-Local** (specific to one repo) or **Global** (user-wide) deployment.
+- **AI-Assisted Creation**: Includes meta-skills that teach your AI how to create new skills (`skill-creator`) or add new agents (`add-agent`).
+- **Extensible**: Add support for any new AI agent in seconds via the `ask add-agent` wizard.
+
+## 📦 Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/NavanithanS/Agent-Skill-Kit.git
+cd Agent-Skill-Kit
+
+# Install in editable mode
+pip install -e .
+```
+
+## 🛠 Usage
+
+### 1. Copy Skills to an Agent ⭐
+**The primary way to use ASK** — Deploy skills to your AI agents using the interactive wizard.
+
+**Interactive Mode** (Recommended):
+```bash
+ask copy
+```
+The wizard guides you through:
+1. **Skill Selection**: Beautiful table showing all skills with descriptions and categories
+2. **Agent Selection**: Compatible agents highlighted for your chosen skill
+3. **Destination**: Choose between local (project) or global (user-wide) installation
+
+**Quick Mode** (with flags):
+```bash
+# Copy specific skill
+ask copy gemini --skill bug-finder
+
+# Copy all compatible skills to an agent
+ask copy claude --all
+```
+
+### 2. List Available Skills
+View your library of skills, including descriptions and supported agents.
+```bash
+ask list
+```
+
+### 3. Create a New Skill
+**AI-Assisted** (Recommended):
+Simply ask your AI agent to create a skill for you:
+```
+Create a new skill for Docker best practices
+
+Make a skill that teaches REST API design
+
+create new skill: explaining-code
+Purpose: Explains code using analogies, ASCII diagrams, and step-by-step walkthroughs. Triggered by queries like "How does this work?"
+Instructions emphasize conversational tone, multiple analogies, and highlighting common misconceptions.
+```
+*Prerequisites: Deploy `ask-skill-creator` to your agent first (see [Tooling Skills](#tooling-skills-meta-skills)).*
+
+**Manual CLI** (Alternative):
+Launch the interactive wizard to generate a standardized skill template.
+```bash
+ask create skill
+```
+
+### 4. Sync All Skills
+Synchronize your entire skill library to all supported agents at once.
+```bash
+ask sync all
+```
+
+### 5. Update Skills
+Keep your installed skills up-to-date with the latest versions from the repository.
+```bash
+ask update
+```
+Features:
+- **Version Checks**: Compares installed version vs source.
+- **Interactive**: Select which skills to update (or use `--yes` to update all).
+- **Safe**: Automatic backup (`SKILL.md.bak`) created before overwriting.
+
+### 6. Add Support for New Agents
+Want to use **Windsurf** or **Aider**? Use the scaffold wizard:
+```bash
+ask add-agent
+```
+This creates the necessary adapter code, making the new agent available instantly.
+
+## 🎯 Supported Agents
+
+| Agent | Local Path (Project) | Global Path (User) | Format |
+|-------|----------------------|--------------------|--------|
+| **Antigravity** | `.agent/skills/` | `~/.gemini/antigravity/skills/` | SKILL.md (YAML) |
+| **Gemini CLI** | `.gemini/skills/` | `~/.gemini/skills/` | SKILL.md (YAML) |
+| **Claude Code** | `.claude/commands/` | `~/.claude/commands/` | Markdown Command |
+| **Codex** | `codex.md` | `~/.codex/instructions/` | Markdown |
+| **Cursor** | `.cursor/rules/` | `~/.cursor/rules/` | Markdown Rules |
+
+## � Available Skills
+
+ASK comes with a curated collection of skills to boost your AI agent's capabilities. Each skill provides specialized instructions and best practices.
+
+### Planning Skills
+
+| Skill | Description | Use Cases |
+|-------|-------------|-----------|
+| **[adr-logger](skills/planning/ask-adr-logger/README.md)** | Automates creation of Architectural Decision Records | • Recording tech decisions<br>• Documenting context & consequences<br>• Maintaining decision history |
+| **[brainstorm](skills/planning/ask-brainstorm/README.md)** | Guidelines for exploring user intent and requirements | • Defining user intent<br>• Gathering requirements<br>• Exploring design options |
+| **[project-memory](skills/planning/ask-project-memory/README.md)** | Maintains a 'Project Brain' of decisions | • Avoiding re-discussions<br>• Checking past decisions<br>• Recording new choices |
+| **[buildmaster](skills/planning/ask-buildmaster/README.md)** | Smart Epic Orchestration Agent | • Epic discovery & scoping<br>• Ticket decomposition<br>• Execution tracking & handoff |
+
+### Coding Skills
+
+| Skill | Description | Use Cases |
+|-------|-------------|-----------|
+| **[bug-finder](skills/coding/ask-bug-finder/README.md)** | Best practices for systematic bug hunting and debugging | • Debugging complex issues<br>• Isolating bugs<br>• Using debugging tools |
+| **[code-reviewer](skills/coding/ask-code-reviewer/README.md)** | AI code reviewer providing constructive feedback | • Code quality checks<br>• Security & performance review<br>• Learning best practices |
+| **[effective-llm-coder](skills/coding/ask-effective-llm-coder/README.md)** | Guides agent in declarative, simple, tenacious coding | • Declarative workflows<br>• Simplicity & tenacity<br>• Iterative refinement |
+| **[commit-assistance](skills/coding/ask-commit-assistance/README.md)** | Assist with code review, staging, and committing | • Pre-commit review<br>• Meaningful commit messages<br>• Staging files |
+| **[explaining-code](skills/coding/ask-explaining-code/README.md)** | Explains code using analogies and diagrams | • Understanding complex code<br>• Visualizing flow<br>• Learning new codebases |
+| **[flutter-architect](skills/coding/ask-flutter-architect/README.md)** | Senior Flutter skill using FVM | • Layer-First Architecture<br>• Stream-based Services<br>• Strict coding conventions |
+| **[flutter-mechanic](skills/coding/ask-flutter-mechanic/README.md)** | Maintenance skill for Flutter projects using FVM | • Clean Build Protocol<br>• iOS/Android fixes<br>• Release protocols |
+| **[laravel-architect](skills/coding/ask-laravel-architect/README.md)** | Senior scaffolding skill for Laravel (SQL/Mongo) | • Logic Layer separation<br>• Hybrid SQL/Mongo Relations<br>• Test-Driven Scaffolding |
+| **[laravel-mechanic](skills/coding/ask-laravel-mechanic/README.md)** | Senior maintenance skill for database safety | • Zero Data Loss protocol<br>• N+1 Query prevention<br>• Queue debugging & forensics |
+| **[owasp-security-review](skills/coding/ask-owasp-security-review/README.md)** | Static code analysis aligned with OWASP Top 10 | • Security scanning<br>• Identifying vulnerabilities<br>• Compliance checks |
+| **[python-refactor](skills/coding/ask-python-refactor/README.md)** | Guidelines for Python code refactoring | • Improving code quality<br>• Refactoring legacy code<br>• Python best practices |
+| **[refactoring-readability](skills/coding/ask-refactoring-readability/README.md)** | Improves code structure for clarity | • Renaming vars/functions<br>• Reducing complexity<br>• Improving readability |
+| **[unit-test-generation](skills/coding/ask-unit-test-generation/README.md)** | Automates creation of comprehensive unit tests | • Generating new tests<br>• Covering edge cases<br>• Improving coverage |
+| **[vue-architect](skills/coding/ask-vue-architect/README.md)** | Expert scaffolding for Vue 3 (Inertia/Nuxt) | • Component blueprints<br>• Stack detection<br>• Best practices enforcement |
+| **[vue-mechanic](skills/coding/ask-vue-mechanic/README.md)** | Expert maintenance skill for Vue 3 (Inertia) | • Fixing navigation reloads<br>• Debugging prop mismatches<br>• Solving reactivity issues |
+| **[component-scaffolder](skills/coding/ask-component-scaffolder/README.md)** | Standardizes UI component creation | • Consistent folder structure<br>• Typed props<br>• Auto-generating tests |
+| **[db-migration-assistant](skills/coding/ask-db-migration-assistant/README.md)** | Ensures safe database schema updates | • Drafting migrations<br>• Creating rollback scripts<br>• Preventing data loss |
+| **[readme-gardener](skills/coding/ask-readme-gardener/README.md)** | Keeps documentation in sync with code | • Updating API docs<br>• Documenting new features<br>• Maintaining README accuracy |
+| **[shadcn-architect](skills/coding/ask-shadcn-architect/README.md)** | Enforces shadcn/ui patterns and consistency | • Preventing style bloat<br>• Enforcing import rules<br>• Promoting accessibility |
+| **[security-sentinel](skills/coding/ask-security-sentinel/README.md)** | Pre-flight security checker for secrets/vulns | • Blocking commits with secrets<br>• Detecting SQL injection<br>• Flagging unsafe Blade usage |
+| **[nextjs-architect](skills/coding/ask-nextjs-architect/README.md)** | Expert scaffolding for Next.js 14+ (App Router) | • Server Components<br>• Server Actions<br>• Metadata API |
+| **[fastapi-architect](skills/coding/ask-fastapi-architect/README.md)** | Expert scaffolding for FastAPI projects | • Pydantic V2<br>• Async SQLAlchemy<br>• Dep Injection |
+| **[docker-expert](skills/coding/ask-docker-expert/README.md)** | Expert guidance on Docker & Containers | • Multi-stage builds<br>• Security best practices<br>• Image optimization |
+
+---
+
+### Tooling Skills (Meta-Skills)
+
+#### 🛠️ ask-skill-creator
+**Description**: Teaches AI agents how to create skills for Agent Skill Kit
+
+**How to Use**:
+```bash
+# Deploy to all agents so they can create skills
+ask sync all
+```
+
+**Use Cases**:
+- **AI-Assisted Skill Creation**: Let your AI agent create new skills by simply asking
+  ```
+  "Create a skill for API design best practices"
+  ```
+- Standardizing skill structure and format
+- Automating skill scaffolding
+- Building your custom skill library
+- Teaching AI agents the skill creation workflow
+
+**Example Workflow**:
+1. Deploy this skill to your agent: `ask copy gemini --skill ask-skill-creator`
+2. Ask your agent: "Create a skill called 'ask-docker-best-practices' for containerization guidelines"
+3. The agent generates the skill files automatically
+
+---
+
+#### 🎯 ask-add-agent
+**Description**: How to add support for new AI code editors to Agent Skill Kit
+
+**How to Use**:
+```bash
+# Deploy to help your agent add new editor support
+ask copy antigravity --skill ask-add-agent
+```
+
+**Use Cases**:
+- **Extending ASK**: Add support for new AI editors (Windsurf, Aider, etc.)
+- Creating custom agent adapters
+- Understanding the agent adapter architecture
+- Contributing new agent support to the project
+
+**Example Workflow**:
+1. Deploy this skill to your agent
+2. Run the wizard: `ask add-agent`
+3. Or ask your agent to help: "Add support for Windsurf editor"
+4. The agent follows the documented process to create the adapter
+
+---
+
+#### 📄 ask-pdf-processing
+**Description**: Handle PDF text extraction, form filling, and merging
+
+**How to Use**:
+```bash
+ask copy antigravity --skill ask-pdf-processing
+```
+
+**Use Cases**:
+- Extracting text from PDF documents
+- Processing PDF forms
+- Merging multiple PDFs
+- PDF automation workflows
+
+---
+
+#### 🧠 ask-skill-capture
+**Description**: Meta-skill. Analyzes the current session's lessons and saves them as a permanent reusable skill.
+
+**How to Use**:
+```bash
+# Deploy to your agent (e.g., Antigravity, Gemini)
+ask copy antigravity --skill ask-skill-capture
+```
+
+**Use Cases**:
+- **Chat-to-Code**: Turn "messy" chat context into a structured skill
+- **Constraint Capture**: Permanently save rules like "Always use FVM" or "Don't use Tailwind"
+- **Workflow Automation**: Save a successful debugging sequence as a reusable protocol
+- **Team Scaling**: Share tacit knowledge with your team via git-committed skills
+
+**Example Workflow**:
+1. You struggle through a task and finally get it right
+2. You say: "Capture this as a skill called 'ask-deployment-protocol'"
+3. The agent analyzes the conversation and generates the `SKILL.md`
+4. You verify and save it
+
+---
+
+### 🚀 Quick Start with Skills
+
+```bash
+# View all available skills
+ask list
+
+# Deploy a specific skill to an agent
+ask copy gemini --skill ask-bug-finder
+
+# Deploy all compatible skills to an agent
+ask copy claude --all
+
+# Sync all skills to all agents
+ask sync all
+
+# Create your own skill (interactive)
+ask create skill
+
+# Or ask your AI agent to create one (if skill-creator is deployed)
+"Create a new skill for API testing best practices"
+```
+
+## �📐 Skill Format
+
+Each skill is a directory containing:
+*   **`skill.yaml`**: Metadata (name, description, tags, supported agents).
+*   **`README.md`**: The actual prompt/instructions for the AI.
+
+> [!IMPORTANT]
+> **Naming Convention**: All skill names must start with the `ask-` prefix (e.g., `ask-bug-finder`, `ask-commit-assistance`).
+
+```yaml
+# skill.yaml
+name: ask-bug-finder
+version: 1.0.0
+category: coding
+agents:
+  - gemini
+  - claude
+  - cursor
+```
+
+## 🧩 Design Principles
+
+1.  **Universal Definition**: Skills are defined in a neutral format that can be adapted to any agent.
+2.  **Local-First, Global-Ready**: Prioritize project-specific skills (checked into git) while supporting user-wide global skills.
+3.  **Safe by Default**: The CLI will **never** silently overwrite an existing skill. It always asks.
+4.  **Agentic Workflow**: The toolkit includes skills (`skill-creator`) specifically designed to help AI agents help *you* build more skills.
+
+## 🗂 Repository Structure
+
+```
+agent-skill-kit/
+├── ask/                     # CLI Source Code
+│   ├── commands/            # logic for create, copy, sync, add-agent
+│   └── utils/               # adapter logic, filesystem helpers
+├── agents/                  # Adapters for each AI agent
+│   ├── gemini/
+│   ├── claude/
+│   ├── codex/
+│   ├── antigravity/
+│   └── cursor/              # (Added via ask add-agent)
+└── skills/                  # The Skill Library
+    ├── coding/
+    └── tooling/
+```
+
+## 🤝 Contributing
+
+Contributions are welcome!
+1.  **Create a Skill**: Use `ask create skill` and submit a PR with your best prompts.
+2.  **Add an Agent**: Use `ask add-agent`, test it, and submit the new adapter.
+
+## License
+
+MIT

agent_skill_kit-0.1.1.dist-info/RECORD

@@ -0,0 +1,127 @@
+agents/__init__.py,sha256=yjvBIa9akGNT4AbiwOW5uhWav1ngk_n-p7R_8MU2r1w,45
+agents/base.py,sha256=crK8bMJ-GfGe-U-ohmgCw34NdfL8K_qlgaVxXEuiPTg,6815
+agents/antigravity/adapter.py,sha256=XYEDwzc-tYC5YiQawJ8Pc9odaoa8SoPC0jF_WzYN_sg,3248
+agents/claude/adapter.py,sha256=BztTKg1uLTPzVOL4tGsVHMimFSdtEXj3qTWTUkvjqFI,4016
+agents/codex/adapter.py,sha256=TjYC9GVthLes3sNSx5uwv9UVhwm5W1WEWZBheDC6wFc,3761
+agents/cursor/adapter.py,sha256=DoHbjdJp2nELzoKcCdtZnQ0-dFG8_S83MoQaAbFKAPg,3696
+agents/gemini/adapter.py,sha256=PGwP-3UrOt6FZtFscro-fezOZ6dAir2TO_HSkrVaiWk,3180
+ask/__init__.py,sha256=XUr7fxXfOW4CN6zDJ8k_Pv9JFdF50vVxXNTqvVtwU94,109
+ask/__main__.py,sha256=GPEM4anOHyTIaedv5rXQIFUhfnohURTYRpAoOTOfXZE,102
+ask/cli.py,sha256=FvJD5s8amG5WLeJLI17nKnThzQuCjD3swwZ5rthB0Rg,814
+ask/commands/__init__.py,sha256=bDribyfKLiuaGKmXomxN6JNHBwZMCkARuHF0jgNESiI,40
+ask/commands/add_agent.py,sha256=vtP-xPXEVtFIjTG8j8cwLa6xsDMMYOxW-DPMWPJK65Y,5053
+ask/commands/copy.py,sha256=FIIZPncb-7ZyB2V15jONPKGNJNWt7HZgx6CAGo3V8Sk,12362
+ask/commands/create.py,sha256=FeX82F51zSc--reIaRHsBwhc_wvmZ5-K86moWPDUDWo,4839
+ask/commands/list_skills.py,sha256=bPwxM0MwrpajhpibcQd3CfkgQkjMniU_tyr4N7x_Qdw,1791
+ask/commands/remove.py,sha256=F9DixGnKsrGh5khavA7YC7s0fBayMtvv2GLOY8RUmVI,3427
+ask/commands/sync.py,sha256=HMNwBi_B_T6DM19eZnTuthXewPpUcC7krUuu3QIwWUE,3231
+ask/commands/update.py,sha256=bXdE7ii6LpB0c8_ZEm7zOkBsx1BW811C7iIfsru_h-4,6616
+ask/templates/skill/README.md,sha256=eAq6NRfBvm_ANUVAxexiemAvk4FpPwrL0SuC8f-Sf6M,252
+ask/templates/skill/skill.yaml,sha256=kgQpzDDE5BrAYbbf7dlUQiZ4BGtxZTV290-HAwy0xos,161
+ask/utils/__init__.py,sha256=CFI2eC8zdD42YVfh4219amy-E2p4aHVPOYy7OI5iCDU,45
+ask/utils/agent_registry.py,sha256=GmGXMQ-cJ7H6OpSiOHOkAJrI4ZS4P_2REetsR6ffHgA,1404
+ask/utils/filesystem.py,sha256=jiq7xyrMmRbLsawCvPQUalrWi_UNRSIV5Pl8TR69Li0,2742
+ask/utils/skill_registry.py,sha256=49tJ2hwt-hKwr5y8jZ27RP-fU0TpCuLtjz1yRMxYXIA,3736
+ask/utils/validators.py,sha256=mKR8A6-c8pKuk6gBxuJxAlEkXIw6klrNY__A1AMdy0I,862
+skills/coding/ask-bug-finder/README.md,sha256=9fxGvrs5RRzEY2OBmeSxV2BzDbv6dK6Pig2Cye0bmCU,4270
+skills/coding/ask-bug-finder/SKILL.md,sha256=rJPA3WQGaAhZs3cgi3lvRwR4sZ_k-zf0mh85wln4QuE,4369
+skills/coding/ask-bug-finder/skill.yaml,sha256=NcOukD1IDBT-e2rRrubWkZWt9-rFsKTIyWUbD8P_S2g,263
+skills/coding/ask-code-reviewer/README.md,sha256=yM778R59iJBif71o9wkSQroJCnpZqfHHMr1WM0D4xMA,3257
+skills/coding/ask-code-reviewer/SKILL.md,sha256=yM778R59iJBif71o9wkSQroJCnpZqfHHMr1WM0D4xMA,3257
+skills/coding/ask-code-reviewer/skill.yaml,sha256=zsrPj9rRtIVeAKqct2erBSgdyDtkJIKm0hwqga9xU4Q,280
+skills/coding/ask-commit-assistance/README.md,sha256=aTFKL6WgmD2VTOCfZS9R2xPtr26Y0sl6wklQp60doRI,809
+skills/coding/ask-commit-assistance/SKILL.md,sha256=bpAe4KIBY3ij3bXWs8fq3co3WbMH_nUHZc4LiRuz0kQ,2583
+skills/coding/ask-commit-assistance/skill.yaml,sha256=CI-nlz44Z4Iv7ZHeSLtTDVb5KfHyRv8vb2Jxx2DXV4A,252
+skills/coding/ask-component-scaffolder/README.md,sha256=l0PknyeVlsGJGEUp8LulPIgmGhZ6QlIGBRBY-jopQSU,1198
+skills/coding/ask-component-scaffolder/SKILL.md,sha256=l0PknyeVlsGJGEUp8LulPIgmGhZ6QlIGBRBY-jopQSU,1198
+skills/coding/ask-component-scaffolder/skill.yaml,sha256=2nF4H-zj3bfW2jM6JUEk2MOb3AlVG99s7KK_oY6BHR0,120
+skills/coding/ask-component-scaffolder/scripts/scaffold_component.py,sha256=Gngf4tUr28yEXYXQ14RUfBjFJ-nouaxFwsYMECuw_5E,1937
+skills/coding/ask-db-migration-assistant/README.md,sha256=Q9bYXEDWDBcUWRpRSuGLrrG_0ITZxx5Z0j0gbjZ8qf4,1638
+skills/coding/ask-db-migration-assistant/SKILL.md,sha256=Q9bYXEDWDBcUWRpRSuGLrrG_0ITZxx5Z0j0gbjZ8qf4,1638
+skills/coding/ask-db-migration-assistant/skill.yaml,sha256=3MFcylOe_3h9xc27T2dZIBbQj-IAP7WIlCqm8rNGuK8,122
+skills/coding/ask-docker-expert/README.md,sha256=n-Z7ypn7MwuhfgJ1-RLYPQVegHrDYZH5-Attqzdisc4,1784
+skills/coding/ask-docker-expert/SKILL.md,sha256=1PZ4Y1dTD3tojyfKHdVCeORiXwirER5uDMdw2DxWi8Y,1790
+skills/coding/ask-docker-expert/skill.yaml,sha256=FO2ASMVCA8Oi0wU83AmgRHMKoP_OlTWy0SESdZeRiLU,303
+skills/coding/ask-effective-llm-coder/README.md,sha256=QHPmgrBjinjXKiqAPou-12O6YE_c2M7wEgjgzuIT3gc,2050
+skills/coding/ask-effective-llm-coder/SKILL.md,sha256=QHPmgrBjinjXKiqAPou-12O6YE_c2M7wEgjgzuIT3gc,2050
+skills/coding/ask-effective-llm-coder/skill.yaml,sha256=FoWqhQXnaX7HyvDLFvRVQY_ApZ6RT3voeRDGGtNP7w8,119
+skills/coding/ask-explaining-code/README.md,sha256=CG370y0RhYhR1PIWt_Ri66LBeZUT-K0-e-ru8DGXbLQ,9876
+skills/coding/ask-explaining-code/SKILL.md,sha256=CG370y0RhYhR1PIWt_Ri66LBeZUT-K0-e-ru8DGXbLQ,9876
+skills/coding/ask-explaining-code/skill.yaml,sha256=QAKMZWb66MWMMrjGjlE9mgAyCt7syBE7OUQKGN2wr-A,300
+skills/coding/ask-fastapi-architect/README.md,sha256=iQktrKWc-62SswmWXgE7fQIIJJ07wMRBvnMclZKM71w,1904
+skills/coding/ask-fastapi-architect/SKILL.md,sha256=iWI7vilDws-0Ii6bEacY1a5xK1tRQuvgx98O8Lm-MF8,1914
+skills/coding/ask-fastapi-architect/skill.yaml,sha256=vrWjKQmvwSRwTAXUtvfuvpW0uvDZHFPgodjZYEJNaLo,301
+skills/coding/ask-flutter-architect/README.md,sha256=xAYbT6Ufkg2B5EfkDIl_2YjT7XTOWVCKvcUPgcbpQ7w,3717
+skills/coding/ask-flutter-architect/SKILL.md,sha256=Y9gftZSX3Pkz6x4X9EfhB2xTgsQe1Ki3_thlsU0_GUg,3741
+skills/coding/ask-flutter-architect/skill.yaml,sha256=FaRvwJGp7jp4Y4mLYSIkf-EDP9ZIIGYDKPNvMiYt3vw,341
+skills/coding/ask-flutter-mechanic/README.md,sha256=XD38q4PNstPWP8kR8FGNPojLPLQvsHv77mY7oOC0l1w,2325
+skills/coding/ask-flutter-mechanic/SKILL.md,sha256=NyGVnrTaHn-SMsnUHfdnQRlmOIpVpPNs801TYpArpUA,2349
+skills/coding/ask-flutter-mechanic/skill.yaml,sha256=9TsOBU_lAuXI_lPe-Iir2YgIZncduFFcGYi_RerUjKw,332
+skills/coding/ask-laravel-architect/README.md,sha256=yVThKmik8pBQRLW87Kkr7DWqARLFefV478qho0OKPsk,3114
+skills/coding/ask-laravel-architect/SKILL.md,sha256=1WeZPRqex0j84_ryAr9qPdWISEzvfcLFOLMOZr_3dfY,3142
+skills/coding/ask-laravel-architect/skill.yaml,sha256=Ck4JJmOmSpJuW3QnDNFLb9fgO-t6MrV4B1eN4UMY1gM,312
+skills/coding/ask-laravel-mechanic/README.md,sha256=o0ITf86qeltpHOfDDGY4-rOQwcEp7qshOKR7EZzm5QY,3825
+skills/coding/ask-laravel-mechanic/SKILL.md,sha256=ALh_nfgH4PuNmvYdPcrJkvGeqr4Cu_nG3gqFdr4Fqlk,3853
+skills/coding/ask-laravel-mechanic/skill.yaml,sha256=YL7E4l4e7744Yi0ld3DSAbVex6C_lB7HdzdyXnEQOvc,301
+skills/coding/ask-nextjs-architect/README.md,sha256=axVGwyrs7TKZa6DlpkwbXVzqwbHkzDsVHNfES7XuVh4,2717
+skills/coding/ask-nextjs-architect/SKILL.md,sha256=haT5Huqzdoe4A7giGymXbh0xC159iDJLXb5BfmkfMFE,2716
+skills/coding/ask-nextjs-architect/skill.yaml,sha256=U63Gs7_UGXYdzLFWBATNtlSn0pt4x0YlhPgOfURHpqg,301
+skills/coding/ask-owasp-security-review/README.md,sha256=zxHOOJxxZ4_xFaNhQKzoreGMC-TLsDUonrEhZMgI9DQ,8360
+skills/coding/ask-owasp-security-review/SKILL.md,sha256=2L9Y-89YBeelCpySNMVXNwpl5XRnbfFggkdL6IT0jrM,8573
+skills/coding/ask-owasp-security-review/skill.yaml,sha256=A7WG-k3OAPE7oeTSl2LY_cJGMJRZuVqNbyMcJX-J0E4,389
+skills/coding/ask-python-refactor/README.md,sha256=zcw3vQSskCLDr_m93IUaULf07iGJ_cfNBkjFc7UoT_U,2257
+skills/coding/ask-python-refactor/SKILL.md,sha256=y3U8fNFajeCNsn5S-HYgOdxsWCfp0zLUy_BQt9o44Bg,2363
+skills/coding/ask-python-refactor/skill.yaml,sha256=u8Mf0AfiwjvlmafVKh-_17Zy4pbPBhKl4yHUZZvrL9s,263
+skills/coding/ask-readme-gardener/README.md,sha256=4tR_z0ymiDLU5WMTcWpjlS-v3f-C8sij2fqKgOY-eiw,1655
+skills/coding/ask-readme-gardener/SKILL.md,sha256=4tR_z0ymiDLU5WMTcWpjlS-v3f-C8sij2fqKgOY-eiw,1655
+skills/coding/ask-readme-gardener/skill.yaml,sha256=_s9flSxILl9KgUsu5g1dEt8JxhNrTSAQlOpESpVYT5Y,115
+skills/coding/ask-refactoring-readability/README.md,sha256=M-daKM0h4FhHHYQj9t-mYH2W1kaFvw-ZWzenfRr2bdI,5758
+skills/coding/ask-refactoring-readability/SKILL.md,sha256=ebW9udF1Sht_geTg2BgsTG_26uygKwOvtmaP62MDeR0,5917
+skills/coding/ask-refactoring-readability/skill.yaml,sha256=9c5vH7UEX_FtQDJkb7RoZFh4NieyZ8PeYjD25Iiqw-4,334
+skills/coding/ask-security-sentinel/README.md,sha256=SywW8n2MwW9d4D-FbXLajhy0X3w-YWpOvelH6wttuxY,731
+skills/coding/ask-security-sentinel/SKILL.md,sha256=SywW8n2MwW9d4D-FbXLajhy0X3w-YWpOvelH6wttuxY,731
+skills/coding/ask-security-sentinel/skill.yaml,sha256=xGOHaVnBUFbJ6qiT-QJCQucKeIN0uxbPGLF7QXQXP6o,117
+skills/coding/ask-shadcn-architect/README.md,sha256=ofIJeoIvHUUa12sgSBP7o1OFwVI4YXSVmK_3hUkfi2E,2516
+skills/coding/ask-shadcn-architect/SKILL.md,sha256=ofIJeoIvHUUa12sgSBP7o1OFwVI4YXSVmK_3hUkfi2E,2516
+skills/coding/ask-shadcn-architect/skill.yaml,sha256=ksgsgQ3ElH0uU6bffD5Mvpw5k1lRt2PnaOsEP9ZEqQs,116
+skills/coding/ask-unit-test-generation/README.md,sha256=xcXbmmO3EWNDMkVw7eJlu4Sm8-VFs2EmbIxMxCfh7lI,7284
+skills/coding/ask-unit-test-generation/SKILL.md,sha256=xcXbmmO3EWNDMkVw7eJlu4Sm8-VFs2EmbIxMxCfh7lI,7284
+skills/coding/ask-unit-test-generation/skill.yaml,sha256=QypBo8DgERsBK3t5RA3oVwWhLMLXiQHmW3rBELPifDc,339
+skills/coding/ask-vue-architect/README.md,sha256=V2VFo-3Gpk1SvfgP3re_Rgybqe7__m16BjbuJvgJJbA,3154
+skills/coding/ask-vue-architect/SKILL.md,sha256=aDqOgiIM0VicmaOAmcZsygtmJ3qnvl3bEX2XqIg4FUk,3178
+skills/coding/ask-vue-architect/skill.yaml,sha256=mfYsX28T-AzpQZ_mvm2wjrPIddFj6TZrOK7JfeaigTg,312
+skills/coding/ask-vue-mechanic/README.md,sha256=sa4ClvjQH1apS9In4m0FwZ--RX_S5JrtVOX-QCLu5co,2940
+skills/coding/ask-vue-mechanic/SKILL.md,sha256=b1732uF86_YbgI7SwRT-DOAsQTvdqHr6C0COl_S_h74,2964
+skills/coding/ask-vue-mechanic/skill.yaml,sha256=oIy_LYl28veOOY1v9-ZttrmzMrPuFjo3g5xMzIoPFIM,318
+skills/planning/ask-adr-logger/README.md,sha256=-IBBBhyLhZc6kd7eVf_3ddKVxAI9AgBpLD4RUACzupo,1351
+skills/planning/ask-adr-logger/SKILL.md,sha256=-IBBBhyLhZc6kd7eVf_3ddKVxAI9AgBpLD4RUACzupo,1351
+skills/planning/ask-adr-logger/skill.yaml,sha256=9cL-DQRpb4tAPIVeWE2y4_dVZR3DVmQ94DMbnDoj_oE,112
+skills/planning/ask-adr-logger/scripts/create_adr.py,sha256=1yebVHxcfnf0go2hyNXTrnqoup1NN7XSZopzrseigvQ,2065
+skills/planning/ask-brainstorm/README.md,sha256=Xq6FL-htaFdm9Klphuo6-qmuNpO-DvOtaHuVbtD5G-A,1828
+skills/planning/ask-brainstorm/SKILL.md,sha256=Xq6FL-htaFdm9Klphuo6-qmuNpO-DvOtaHuVbtD5G-A,1828
+skills/planning/ask-brainstorm/skill.yaml,sha256=Ln7ewBQrXuB_BeBooFgRZxP98INQmaXM92ktq_tuNQY,112
+skills/planning/ask-buildmaster/README.md,sha256=hCg9hW2c2OJ3YAMWX8Xl0lpQ9bo9vjOqzHgfteqRhMY,13877
+skills/planning/ask-buildmaster/SKILL.md,sha256=hCg9hW2c2OJ3YAMWX8Xl0lpQ9bo9vjOqzHgfteqRhMY,13877
+skills/planning/ask-buildmaster/skill.yaml,sha256=6zcTCdBS7OPvVPOwcV5s1U8ZbSPvvJnf1XbKvDd5zyQ,113
+skills/planning/ask-project-memory/README.md,sha256=M8HKSzQ77Qz351kFZDh-vzVfD9NqJinlEnKkQIVinYM,805
+skills/planning/ask-project-memory/SKILL.md,sha256=M8HKSzQ77Qz351kFZDh-vzVfD9NqJinlEnKkQIVinYM,805
+skills/planning/ask-project-memory/skill.yaml,sha256=OLP-uMHlnrbyd3SJIGSZox-c7YILOqzjH5F7fzF6SyI,116
+skills/tooling/ask-add-agent/README.md,sha256=gW9rEfrhch3bzNHQx_BC9WqqOe1zplLjaiVT5B_VHM4,4720
+skills/tooling/ask-add-agent/skill.yaml,sha256=wV60xW2dFvVD98Vxa2RzMkRuVC0He4uO5GEjLgyEbF8,252
+skills/tooling/ask-pdf-processing/README.md,sha256=vOw7Qu5QlMgpai9gtimLI2b3c4ZPHsb_H-qhKorC0so,6907
+skills/tooling/ask-pdf-processing/skill.yaml,sha256=cvUQ-HveWXnKyfMsYL73E7iFAiUTWZ13CQI8HnAH76g,339
+skills/tooling/ask-pdf-processing/reference/api_usage.md,sha256=1fUZsBCbVDxprGdVq9-Zs5MY6i2j1v24QTTEIsfbQdY,5997
+skills/tooling/ask-pdf-processing/reference/form_mappings.yaml,sha256=nGGPAo3tFd1foBXYJVvMrqN934J-XmGOJZegaqqnujA,2938
+skills/tooling/ask-pdf-processing/scripts/extract_text.py,sha256=_a662WZ5XQQdmA1SpOg5I04KzIuuLBFAO7rjiDDX89M,3401
+skills/tooling/ask-pdf-processing/scripts/fill_form.py,sha256=gmuTetJ7cIsiTuJDBfvwDptVEJPFcCrJnkqUeRD_a70,5215
+skills/tooling/ask-pdf-processing/scripts/merge_pdfs.py,sha256=lS-9s4GV0lNBRBcy-RqJk_kxznPhg6r5QPCAWJ7CyUI,4261
+skills/tooling/ask-skill-capture/README.md,sha256=DL0vPlYKNPBKtP3Eo2wyb9-A9X2bDb4M74uvWgGuwA8,1821
+skills/tooling/ask-skill-capture/skill.yaml,sha256=KnJsu8VY-MfKGUwpWBoW3O0-5Cqb66LWPnmOL-X0Roc,276
+skills/tooling/ask-skill-creator/README.md,sha256=k13CxRrPWzoezr9Kriz3_sVEVFr_0CEX5m1kaG0xr-s,5685
+skills/tooling/ask-skill-creator/SKILL.md,sha256=21Zdx11ct_V8R69oocuzEKgGnWKSA8M-42yRuNGfnNk,5758
+skills/tooling/ask-skill-creator/skill.yaml,sha256=8QxYJna4W6LEvboGtetz7gCSJIwQiwtF7F7spGiEUKw,259
+skills/workflows/skill-creator/workflow.md,sha256=V2Q_dnzyzA06ev58ZpNfAS2y0OZdck1443nthYktA7s,2060
+agent_skill_kit-0.1.1.dist-info/METADATA,sha256=uRv9RCwVT6sA4LaBqM-AhF9LIQk_z6E8Eui36pJxboI,16381
+agent_skill_kit-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+agent_skill_kit-0.1.1.dist-info/entry_points.txt,sha256=kDEUvxGsgvP-Tt6BJCyghngiFCx5hbZtL_PFkv2iTVk,37
+agent_skill_kit-0.1.1.dist-info/RECORD,,

agent_skill_kit-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

agent_skill_kit-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ask = ask.cli:main

agents/__init__.py

@@ -0,0 +1 @@
+"""Agent adapters for skill distribution."""

agents/antigravity/adapter.py

@@ -0,0 +1,97 @@
+"""Antigravity adapter - transforms skills for Google Antigravity."""
+
+from pathlib import Path
+from typing import Dict
+
+from agents.base import BaseAdapter
+from ask.utils.skill_registry import get_skill_readme
+
+
+class AntigravityAdapter(BaseAdapter):
+    """Adapter for Antigravity skill format.
+    
+    Paths (from https://antigravity.google/docs/skills):
+    - Local (project): .agent/skills/<skill-name>/SKILL.md
+    - Global (user):   ~/.gemini/antigravity/skills/<skill-name>/SKILL.md
+    """
+    
+    def __init__(self, use_global: bool = False, project_root: Path = None):
+        if use_global:
+            # Global: ~/.gemini/antigravity/skills/
+            self.target_dir = Path.home() / ".gemini" / "antigravity" / "skills"
+        else:
+            # Local: .agent/skills/
+            self.project_root = project_root or Path.cwd()
+            self.target_dir = self.project_root / ".agent" / "skills"
+    
+    def get_target_path(self, skill: Dict, name: str = None) -> Path:
+        """Get the target path for a skill."""
+        skill_name = name or skill.get("name", "unknown")
+        return self.target_dir / skill_name / "SKILL.md"
+    
+    def transform(self, skill: Dict) -> str:
+        """
+        Transform a skill into Antigravity format.
+        
+        Antigravity uses SKILL.md with YAML frontmatter.
+        """
+        name = skill.get("name", "Unknown")
+        description = skill.get("description", "")
+        version = skill.get("version", "0.0.0")
+        readme = get_skill_readme(skill) or ""
+        
+        content = f"""---
+name: {name}
+version: {version}
+description: {description}
+---
+
+{readme}
+"""
+        return content
+
+    def install_resources(self, skill: Dict, target_dir: Path, dry_run: bool = False, force: bool = False) -> Dict[str, bool]:
+        """
+        Install scripts and sidecar files to the skill directory.
+        """
+        import shutil
+        
+        skill_path_str = skill.get("_path")
+        if not skill_path_str:
+            return {"conflict": False}
+            
+        skill_path = Path(skill_path_str)
+        conflicts = []
+        resources_to_copy = ["scripts", "reference", "images", "assets", "examples.md", "reference.md"]
+        
+        # Check conflicts
+        for resource in resources_to_copy:
+            src = skill_path / resource
+            dst = target_dir / resource
+            if src.exists() and dst.exists() and not force:
+                 conflicts.append(f"Resource exists: {dst}")
+
+        if conflicts:
+            return {"conflict": True, "details": ", ".join(conflicts)}
+            
+        if dry_run:
+            return {"conflict": False}
+            
+        # Perform Copy
+        for resource in resources_to_copy:
+            src = skill_path / resource
+            dst = target_dir / resource
+            
+            if src.exists():
+                if force and dst.exists():
+                    if dst.is_dir():
+                        shutil.rmtree(dst)
+                    else:
+                        dst.unlink()
+
+                if src.is_dir():
+                    shutil.copytree(src, dst)
+                else:
+                    shutil.copy2(src, dst)
+                    
+        return {"conflict": False}