skill-blast 1.0.0__tar.gz

skill_blast-1.0.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,49 @@
+name: Bug Report
+description: Something broke — help us fix it
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: "Thanks for taking the time to report a bug!"
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      placeholder: "e.g. Ubuntu 24.04 / macOS 15 / Windows 11"
+    validations:
+      required: true
+
+  - type: input
+    id: python
+    attributes:
+      label: Python Version
+      placeholder: "python --version output"
+    validations:
+      required: true
+
+  - type: input
+    id: skill-blast-version
+    attributes:
+      label: skill-blast Version
+      placeholder: "skill-blast --version output"
+    validations:
+      required: true
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: What did you run and what did you see?
+      placeholder: |
+        Command: skill-blast --all
+        Error: ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect?
+    validations:
+      required: true

skill_blast-1.0.0/.github/ISSUE_TEMPLATE/skill_request.yml

@@ -0,0 +1,55 @@
+name: Skill Request
+description: Suggest a new skill to add to the list
+labels: ["skill-request"]
+body:
+  - type: markdown
+    attributes:
+      value: "Know a great AI agent skill that should be in skill-blast? Tell us about it!"
+
+  - type: input
+    id: skill-name
+    attributes:
+      label: Skill Name
+      placeholder: "e.g. my-awesome-skill"
+    validations:
+      required: true
+
+  - type: input
+    id: repo
+    attributes:
+      label: GitHub Repo
+      placeholder: "owner/repo  (must be public)"
+    validations:
+      required: true
+
+  - type: input
+    id: subpath
+    attributes:
+      label: Subpath (if skill is inside a larger repo)
+      placeholder: "e.g. skills/my-skill  (leave blank if whole repo is the skill)"
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      options:
+        - UI/Design
+        - Content
+        - Writing
+        - Research
+        - Marketing
+        - Product
+        - Engineering
+        - Media
+        - Health
+        - New category (explain below)
+    validations:
+      required: true
+
+  - type: textarea
+    id: why
+    attributes:
+      label: Why should it be included?
+      description: What problem does it solve? What makes it stand out?
+    validations:
+      required: true

skill_blast-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-test:
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Import check
+        run: python -c "from skill_blast.cli import main; from skill_blast.skills import ALL_SKILLS; print(f'OK — {len(ALL_SKILLS)} skills loaded')"
+
+      - name: CLI --list smoke test
+        run: skill-blast --list
+
+      - name: CLI --dry-run smoke test
+        run: skill-blast --all --dry-run --agents claude-code
+
+      - name: Run tests
+        run: pytest tests/ -v
+
+  publish:
+    name: Publish to PyPI
+    needs: lint-and-test
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    environment: pypi
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install hatch
+        run: pip install hatch
+
+      - name: Build
+        run: hatch build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

skill_blast-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install hatch
+        run: pip install hatch
+
+      - name: Build dist
+        run: hatch build
+
+      - name: Extract changelog for this version
+        id: changelog
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          NOTES=$(awk "/^## \[$VERSION\]/{flag=1; next} /^## \[/{flag=0} flag" CHANGELOG.md)
+          echo "notes<<EOF" >> "$GITHUB_OUTPUT"
+          echo "$NOTES" >> "$GITHUB_OUTPUT"
+          echo "EOF" >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body: ${{ steps.changelog.outputs.notes }}
+          files: dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

skill_blast-1.0.0/.gitignore

@@ -0,0 +1,35 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+*.whl
+
+# Virtual envs
+.venv/
+venv/
+env/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# Hatch
+.hatch/

skill_blast-1.0.0/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to skill-blast are documented here.  
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+---
+
+## [Unreleased]
+
+### Added
+- `--uninstall` flag to remove installed skills from agent directories
+- `--check` flag for health diagnostics (broken symlinks, cache/store status, git connectivity)
+- `--version` flag to print current version
+- Integration tests for installer logic (mocked filesystem + subprocess)
+- Agent detection tests
+- Troubleshooting guide in README
+- Management commands section in README
+
+### Changed
+- Replaced `YOUR_USERNAME` placeholder with `Venkatesh-6921` in all files
+
+## [1.0.0] — 2026-05-10
+
+### Added
+- 50 curated AI agent skills across 9 categories
+- Interactive wizard for non-developers (no flags needed)
+- Auto-detection for 8 agents: Claude Code, OpenCode, Antigravity, Gemini CLI, Cursor, Windsurf, Continue.dev, Aider
+- Cross-platform: Linux, macOS, Windows
+- One-liner installers: `install.sh`, `install.ps1`, `install.bat`
+- PyPI package: `pip install skill-blast`
+- `--dry-run`, `--update`, `--list`, `--only`, `--skip`, `--agents` flags
+- Symlink-based install on Linux/macOS (copy-based on Windows)
+- Central skill store at `~/.skill-blast/` shared across all agents
+- Rich TUI with progress bar, live status, summary table

skill_blast-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,114 @@
+# Contributing to skill-blast
+
+Thanks for helping make skill-blast better! Here's everything you need.
+
+---
+
+## Ways to contribute
+
+- **Add a new skill** — found a great one not in the list?
+- **Fix a broken repo** — skill URLs change; PRs to update are always welcome
+- **Improve detection** — better agent auto-detection for any platform
+- **Bug reports** — open an issue with your OS + Python version
+
+---
+
+## Adding a new skill
+
+1. **Fork** the repo and clone your fork
+2. Open `skill_blast/skills.py`
+3. Add a `Skill(...)` entry to `ALL_SKILLS`:
+
+```python
+Skill(
+    id=51,                              # next available ID
+    name="my-skill-name",              # slug, used as folder name (no spaces)
+    repo="github-owner/repo-name",     # GitHub owner/repo
+    subpath="path/to/skill/dir",       # None if the whole repo is the skill
+    desc="One-line description",       # shown in --list and progress bar
+    category="Engineering",            # must match an existing category
+    tags=["tag1", "tag2"],             # searchable tags (future use)
+),
+```
+
+4. **Verify the `subpath`** (important!):
+
+   If the skill lives inside a larger repo (e.g., `anthropics/skills` → `skills/frontend-design`):
+   ```bash
+   # Clone the repo and check the subpath exists
+   git clone --depth=1 https://github.com/owner/repo /tmp/test-repo
+   ls /tmp/test-repo/path/to/skill/   # should contain SKILL.md or similar
+   rm -rf /tmp/test-repo
+   ```
+   If the entire repo *is* the skill, set `subpath=None`.
+
+5. **Test locally:**
+
+```bash
+pip install -e .
+skill-blast --dry-run --only Engineering   # check it appears in list
+skill-blast --list --only Engineering      # verify metadata looks right
+skill-blast --only Engineering             # actually install
+skill-blast --check                        # verify symlinks are healthy
+```
+
+6. **Run the test suite:**
+
+```bash
+pytest tests/ -v
+```
+
+7. Open a PR with:
+   - The `skills.py` change
+   - A one-line note in `CHANGELOG.md` under `Unreleased`
+
+---
+
+## Categories
+
+| Category | When to use |
+|---|---|
+| `UI/Design` | Anything about visual output, CSS, color, diagrams |
+| `Content` | Social media, posts, hooks, publishing |
+| `Writing` | Prose style, editing, humanizing |
+| `Research` | Information gathering, synthesis, citations |
+| `Marketing` | SEO, CRO, email, ads, copywriting |
+| `Product` | PM frameworks, JTBD, strategy |
+| `Engineering` | Code quality, tooling, automation |
+| `Media` | Video, audio, generative media |
+| `Health` | Medical, wellness, personal data |
+
+---
+
+## Development setup
+
+```bash
+git clone https://github.com/Venkatesh-6921/skill-blast
+cd skill-blast
+python -m venv .venv
+source .venv/bin/activate      # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+---
+
+## Code style
+
+- Python 3.9+ compatible
+- No external dependencies beyond `rich`
+- Keep `installer.py` pure — no UI code there
+- All new platform logic goes in `agents.py`
+
+---
+
+## Reporting a broken skill
+
+Open an issue with title: `[broken] skill-name` and include:
+- Error message from skill-blast
+- Output of `git clone https://github.com/owner/repo --depth=1` run manually
+
+---
+
+## License
+
+By contributing, you agree your changes are licensed under MIT.

skill_blast-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 skill-blast contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.