devskills-cli 0.1.1__tar.gz → 0.1.2__tar.gz

devskills_cli-0.1.2/.github/workflows/docs.yml

@@ -0,0 +1,24 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install MkDocs
+        run: pip install mkdocs-material
+
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force

devskills_cli-0.1.2/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: devskills-cli
+Version: 0.1.2
+Summary: Interactive CLI to scaffold AI production projects using uv
+Project-URL: Homepage, https://github.com/Iam-Divyesh/devcli
+Project-URL: Documentation, https://iam-divyesh.github.io/devcli
+Project-URL: Repository, https://github.com/Iam-Divyesh/devcli
+Project-URL: Issues, https://github.com/Iam-Divyesh/devcli/issues
+License: MIT
+Keywords: ai,claude,cli,genai,ml,scaffold,uv
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.0.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# devskills-cli
+
+An interactive CLI to scaffold AI/ML production projects using the `uv` package manager. No flags — just prompts.
+
+## Installation
+
+```bash
+pip install devskills-cli
+```
+
+Requires Python 3.10+ and [`uv`](https://docs.astral.sh/uv/getting-started/installation/).
+
+---
+
+## Commands
+
+### `dev start` — Scaffold a new project
+
+Run this inside any directory:
+
+```bash
+dev start
+```
+
+It will ask you four questions:
+
+1. **Project name** — type a name to create a new folder, or `.` to scaffold in the current directory
+2. **Project structure** — choose one:
+   - `AI / ML` — includes `app/`, `src/inference/`, `src/services/`, `src/database/`, `models/`, `tests/`, `docs/`, `config/`, `.github/`
+   - `API` — includes `app/`, `src/services/`, `src/database/`, `tests/`, `docs/`, `config/`
+   - `Minimal` — includes `app/`, `tests/`, `config/`
+   - `None` — empty project (just `pyproject.toml` + `.gitignore`)
+3. **Optional features** — space to toggle, enter to confirm:
+   - `Docker` — adds `Dockerfile` and `.dockerignore`
+   - `Claude` — adds `.claude/` folder for [Claude Code](https://claude.ai/code) integration
+4. **Create `.venv` now?** — runs `uv venv` immediately if yes
+
+After confirming, your project is ready with next steps printed on screen.
+
+---
+
+### `dev skills` — Manage Claude Code skills
+
+These commands require a `.claude/` folder in your current directory (created by `dev start` when you select the Claude feature).
+
+#### Search and install a skill
+
+```bash
+dev skills find <keyword>
+```
+
+Searches [skills.sh](https://skills.sh) for matching skills, lets you pick one, and installs it into `.claude/skills/`.
+
+Example:
+
+```bash
+dev skills find debugging
+```
+
+#### Install a specific skill directly
+
+```bash
+dev skills install <owner/repo>
+```
+
+Install one or more skills by their reference without searching:
+
+```bash
+dev skills install anthropics/skills
+dev skills install anthropics/skills some-other/skill
+```
+
+#### Browse top skills
+
+```bash
+dev skills list
+```
+
+Shows the top skills from the [skills.sh](https://skills.sh) leaderboard in a table.
+
+---
+
+## Example Workflow
+
+```bash
+# Install the CLI
+pip install devskills-cli
+
+# Scaffold a new AI project
+dev start
+# > Project name: my-agent
+# > Structure: AI / ML
+# > Features: [x] Claude  [ ] Docker
+# > Create .venv? Yes
+
+cd my-agent
+uv sync
+cp .env.example .env
+
+# Browse and install Claude Code skills
+dev skills list
+dev skills find pdf
+```
+
+---
+
+## Requirements
+
+| Tool | Purpose |
+|---|---|
+| Python 3.10+ | Runtime |
+| [`uv`](https://docs.astral.sh/uv/getting-started/installation/) | Project init and virtualenv |
+| [Node.js / npx](https://nodejs.org) | Only needed for `dev skills` commands |
+
+---
+
+## Links
+
+- PyPI: [pypi.org/project/devskills-cli](https://pypi.org/project/devskills-cli/)
+- Skills marketplace: [skills.sh](https://skills.sh)

devskills_cli-0.1.2/README.md

@@ -0,0 +1,120 @@
+# devskills-cli
+
+An interactive CLI to scaffold AI/ML production projects using the `uv` package manager. No flags — just prompts.
+
+## Installation
+
+```bash
+pip install devskills-cli
+```
+
+Requires Python 3.10+ and [`uv`](https://docs.astral.sh/uv/getting-started/installation/).
+
+---
+
+## Commands
+
+### `dev start` — Scaffold a new project
+
+Run this inside any directory:
+
+```bash
+dev start
+```
+
+It will ask you four questions:
+
+1. **Project name** — type a name to create a new folder, or `.` to scaffold in the current directory
+2. **Project structure** — choose one:
+   - `AI / ML` — includes `app/`, `src/inference/`, `src/services/`, `src/database/`, `models/`, `tests/`, `docs/`, `config/`, `.github/`
+   - `API` — includes `app/`, `src/services/`, `src/database/`, `tests/`, `docs/`, `config/`
+   - `Minimal` — includes `app/`, `tests/`, `config/`
+   - `None` — empty project (just `pyproject.toml` + `.gitignore`)
+3. **Optional features** — space to toggle, enter to confirm:
+   - `Docker` — adds `Dockerfile` and `.dockerignore`
+   - `Claude` — adds `.claude/` folder for [Claude Code](https://claude.ai/code) integration
+4. **Create `.venv` now?** — runs `uv venv` immediately if yes
+
+After confirming, your project is ready with next steps printed on screen.
+
+---
+
+### `dev skills` — Manage Claude Code skills
+
+These commands require a `.claude/` folder in your current directory (created by `dev start` when you select the Claude feature).
+
+#### Search and install a skill
+
+```bash
+dev skills find <keyword>
+```
+
+Searches [skills.sh](https://skills.sh) for matching skills, lets you pick one, and installs it into `.claude/skills/`.
+
+Example:
+
+```bash
+dev skills find debugging
+```
+
+#### Install a specific skill directly
+
+```bash
+dev skills install <owner/repo>
+```
+
+Install one or more skills by their reference without searching:
+
+```bash
+dev skills install anthropics/skills
+dev skills install anthropics/skills some-other/skill
+```
+
+#### Browse top skills
+
+```bash
+dev skills list
+```
+
+Shows the top skills from the [skills.sh](https://skills.sh) leaderboard in a table.
+
+---
+
+## Example Workflow
+
+```bash
+# Install the CLI
+pip install devskills-cli
+
+# Scaffold a new AI project
+dev start
+# > Project name: my-agent
+# > Structure: AI / ML
+# > Features: [x] Claude  [ ] Docker
+# > Create .venv? Yes
+
+cd my-agent
+uv sync
+cp .env.example .env
+
+# Browse and install Claude Code skills
+dev skills list
+dev skills find pdf
+```
+
+---
+
+## Requirements
+
+| Tool | Purpose |
+|---|---|
+| Python 3.10+ | Runtime |
+| [`uv`](https://docs.astral.sh/uv/getting-started/installation/) | Project init and virtualenv |
+| [Node.js / npx](https://nodejs.org) | Only needed for `dev skills` commands |
+
+---
+
+## Links
+
+- PyPI: [pypi.org/project/devskills-cli](https://pypi.org/project/devskills-cli/)
+- Skills marketplace: [skills.sh](https://skills.sh)

devskills_cli-0.1.2/docs/CONTRIBUTING.md

@@ -0,0 +1,242 @@
+# Contributing to devskills-cli
+
+This guide explains how the codebase is structured and how to make changes.
+
+---
+
+## Project Structure
+
+```
+devskills/
+├── main.py               # CLI entry point — all commands defined here
+├── core/
+│   ├── prompts.py        # All interactive user prompts (questionary)
+│   ├── scaffold.py       # Creates base dirs/files + runs uv init/venv
+│   ├── generator.py      # Orchestrates the full project generation flow
+│   └── skills.py         # Interfaces with skills.sh API and npx CLI
+└── templates/
+    ├── helpers.py         # make_dir() and make_file() utilities
+    ├── docker.py          # Dockerfile + .dockerignore template
+    ├── claude.py          # .claude/ folder template
+    ├── agents.py          # agents/, prompts/, tools/, memory/ (unused in prompts)
+    └── features.py        # features/example_feature/ (unused in prompts)
+```
+
+---
+
+## Local Setup
+
+```bash
+git clone <repo>
+cd "Project Commands"
+
+# Create virtualenv and install in editable mode
+python -m venv .venv
+.venv\Scripts\activate          # Windows
+# source .venv/bin/activate     # Mac/Linux
+
+pip install -e .
+
+# Test it
+dev --help
+dev start
+```
+
+---
+
+## How to Make Changes
+
+### Modify a CLI command
+
+All commands live in `devskills/main.py`.
+
+- `dev start` → `start()` function
+- `dev skills find` → `skills_find()` function
+- `dev skills install` → `skills_install()` function
+- `dev skills list` → `skills_list()` function
+
+Add a new top-level command with `@app.command("name")`, or add to the skills subgroup with `@skills_app.command("name")`.
+
+---
+
+### Change what gets asked during `dev start`
+
+All interactive prompts are in `devskills/core/prompts.py`.
+
+Each function uses `questionary` and returns a value passed to `generator.generate()`:
+
+| Function | Returns | Used for |
+|---|---|---|
+| `ask_location()` | `str` | Project name or `.` |
+| `ask_structure()` | `str` | `aiml`, `api`, `minimal`, `none` |
+| `ask_features()` | `list[str]` | Selected feature keys |
+| `ask_venv()` | `bool` | Whether to run `uv venv` |
+| `ask_confirm()` | `bool` | Final yes/no confirmation |
+
+To add a new prompt, define the function here and call it from `start()` in `main.py`.
+
+---
+
+### Change the base directory structure
+
+`devskills/core/scaffold.py` controls what folders and files are created for each structure type.
+
+Edit `_STRUCTURE_DIRS` to add or remove directories:
+
+```python
+_STRUCTURE_DIRS = {
+    "aiml": [
+        "app",
+        "src/inference",
+        # add more dirs here
+    ],
+    ...
+}
+```
+
+Edit `create_base()` to add or change boilerplate files (e.g. `.gitignore`, `app/main.py`).
+
+---
+
+### Modify an existing template
+
+Templates live in `devskills/templates/`. Each one has a `create(project_path: Path)` function.
+
+- **Docker** → `devskills/templates/docker.py` — edit `Dockerfile` or `.dockerignore` content
+- **Claude** → `devskills/templates/claude.py` — edit `.claude/CLAUDE.md` or `.claude/AGENTS.md` content
+
+Use the helper utilities (always idempotent — safe to re-run):
+
+```python
+from devskills.templates.helpers import make_dir, make_file
+
+make_dir(project_path / "some/new/folder")
+make_file(project_path / "some/file.txt", "file content here")
+```
+
+`make_file()` will not overwrite an existing file.
+
+---
+
+### Add a new optional feature template
+
+Three steps:
+
+**1. Create the template module** in `devskills/templates/<feature>.py`:
+
+```python
+from pathlib import Path
+from devskills.templates.helpers import make_dir, make_file
+
+def create(project_path: Path) -> None:
+    make_dir(project_path / "my_new_folder")
+    make_file(project_path / "my_new_folder" / "example.py", "# example\n")
+```
+
+**2. Register it in `devskills/core/generator.py`**:
+
+```python
+from devskills.templates import docker, claude, my_feature  # add import
+
+_TEMPLATE_MAP = {
+    "docker": docker.create,
+    "claude": claude.create,
+    "my_feature": my_feature.create,  # add entry
+}
+```
+
+**3. Expose it in `devskills/core/prompts.py`** inside `ask_features()`:
+
+```python
+choices=[
+    questionary.Choice(title="[Docker]    Dockerfile + .dockerignore", value="docker"),
+    questionary.Choice(title="[Claude]    .claude/ folder for Claude Code", value="claude"),
+    questionary.Choice(title="[MyFeature] Description of your feature", value="my_feature"),  # add
+],
+```
+
+The `value` string must match the key in `_TEMPLATE_MAP`.
+
+---
+
+### Change the skills.sh integration
+
+`devskills/core/skills.py` handles all communication with skills.sh:
+
+- `search_skills_sh(query)` — runs `npx skills find <query>`, parses output with regex
+- `list_top_skills()` — calls `https://skills.sh/api/top` via `httpx`
+- `install_skill(ref, target)` — runs `npx skills add <repo> -a claude-code -y`
+- `assert_claude_dir(cwd)` — validates `.claude/` folder exists before installing
+
+The API base URL is `_SKILLS_SH_API = "https://skills.sh/api"` — change this if the endpoint changes.
+
+---
+
+## Build & Publish
+
+### Bump the version
+
+Edit `pyproject.toml`:
+
+```toml
+[project]
+version = "0.1.2"   # increment this
+```
+
+Follow [semver](https://semver.org): `MAJOR.MINOR.PATCH`
+- Patch: bug fixes
+- Minor: new features, backwards compatible
+- Major: breaking changes
+
+### Build
+
+```bash
+pip install build
+python -m build
+```
+
+This creates:
+```
+dist/
+  devskills_cli-0.1.2-py3-none-any.whl
+  devskills_cli-0.1.2.tar.gz
+```
+
+### Test the build locally
+
+```bash
+pip install dist/devskills_cli-0.1.2-py3-none-any.whl
+dev start
+```
+
+### Publish to PyPI
+
+```bash
+pip install twine
+twine upload dist/*
+# username: __token__
+# password: your PyPI API token (store it in .env, never commit it)
+```
+
+Or with token from env:
+
+```bash
+source .env
+twine upload dist/* -u __token__ -p "$PYPI_API_TOKEN"
+```
+
+---
+
+## Dependencies
+
+Defined in `pyproject.toml`. To add a dependency:
+
+1. Add it under `[project] dependencies`
+2. Run `pip install -e .` to update your local environment
+
+| Package | Purpose |
+|---|---|
+| `typer` | CLI framework (commands, args, help text) |
+| `questionary` | Interactive prompts (select, checkbox, text) |
+| `rich` | Terminal colors, tables, spinners, panels |
+| `httpx` | HTTP client for skills.sh API |

devskills_cli-0.1.2/docs/commands/skills.md

@@ -0,0 +1,65 @@
+# dev skills
+
+Manage Claude Code skills from [skills.sh](https://skills.sh).
+
+!!! note "Requirement"
+    These commands require a `.claude/` folder in your current directory.
+    Create one by running `dev start` and selecting the **Claude** feature.
+
+---
+
+## dev skills find
+
+Search for a skill by keyword and install it interactively.
+
+```bash
+dev skills find <keyword>
+```
+
+**Example:**
+
+```bash
+dev skills find debugging
+```
+
+This searches skills.sh, presents a list of matches, and installs your selection into `.claude/skills/`.
+
+---
+
+## dev skills install
+
+Install one or more skills directly by their `owner/repo` reference.
+
+```bash
+dev skills install <owner/repo> [<owner/repo> ...]
+```
+
+**Examples:**
+
+```bash
+# Install a single skill
+dev skills install anthropics/skills
+
+# Install multiple skills at once
+dev skills install anthropics/skills some-other/skill
+```
+
+---
+
+## dev skills list
+
+Browse the top skills from the skills.sh leaderboard.
+
+```bash
+dev skills list
+```
+
+Displays a table of top-ranked skills with their names and descriptions. Use this to discover what's available before running `dev skills find` or `dev skills install`.
+
+---
+
+## How skills work
+
+Skills are installed into `.claude/skills/` in your project. Claude Code automatically reads them and uses them as reusable instructions for tasks like testing, deploying, or debugging.
+
+Learn more at [skills.sh](https://skills.sh).

devskills_cli-0.1.2/docs/commands/start.md

@@ -0,0 +1,114 @@
+# dev start
+
+Scaffold a new AI/ML production project interactively.
+
+```bash
+dev start
+```
+
+No flags. All configuration is done through interactive prompts.
+
+---
+
+## Prompts
+
+### 1. Project name
+
+```
+Project name (or . to scaffold in current folder):
+```
+
+- Type a name to create a new subdirectory (e.g. `my-agent`)
+- Type `.` to scaffold directly in the current directory
+
+---
+
+### 2. Project structure
+
+Choose the folder layout that matches your project type:
+
+| Option | Directories created |
+|--------|-------------------|
+| **AI / ML** | `app/` `src/inference/` `src/services/` `src/database/` `models/` `tests/` `docs/` `config/` `.github/workflows/` |
+| **API** | `app/` `src/services/` `src/database/` `tests/` `docs/` `config/` |
+| **Minimal** | `app/` `tests/` `config/` |
+| **None** | Empty project — just `pyproject.toml` + `.gitignore` |
+
+All structures include:
+
+- `pyproject.toml` (via `uv init`)
+- `.gitignore` (pre-configured for Python + ML artifacts)
+- `.python-version` (set to `3.11`)
+- `app/main.py`
+- `.env` + `.env.example`
+
+---
+
+### 3. Optional features
+
+Toggle with `space`, confirm with `enter`:
+
+**Docker**
+
+Adds:
+```
+Dockerfile
+.dockerignore
+```
+
+**Claude**
+
+Adds:
+```
+.claude/
+├── CLAUDE.md       # Project context for Claude Code
+└── AGENTS.md       # Agent instructions
+```
+
+---
+
+### 4. Virtual environment
+
+```
+❯ Yes — create .venv now (runs uv venv)
+  No  — I'll do it manually
+```
+
+Choosing **Yes** runs `uv venv` in the project directory immediately.
+
+---
+
+## What gets created (AI/ML example)
+
+```
+my-ai-api/
+├── app/
+│   └── main.py
+├── src/
+│   ├── inference/
+│   ├── services/
+│   └── database/
+├── models/
+├── tests/
+├── docs/
+├── config/
+│   └── settings.py
+├── .github/
+│   └── workflows/
+├── .claude/            # if Claude selected
+│   ├── CLAUDE.md
+│   └── AGENTS.md
+├── Dockerfile          # if Docker selected
+├── .dockerignore       # if Docker selected
+├── .env
+├── .env.example
+├── .gitignore
+├── .python-version
+└── pyproject.toml
+```
+
+---
+
+## Idempotent
+
+Running `dev start` on an existing directory is safe — it will not overwrite files that already exist.