skillbot 0.2.0

Add your description here

skillbot

A bot which uses skills to do work.

Tech Stack

Category	Tool
Language	Python >= 3.13
Package Manager	uv
Build Backend	Hatchling
Linter & Formatter	Ruff
Type Checker	mypy (strict mode)
Testing	pytest
Commit Convention	Commitizen (Conventional Commits)
Git Hooks	pre-commit
CI/CD	GitHub Actions
Package Registry	PyPI

Local Development

Prerequisites

• Python >= 3.13
• uv

Setup

Clone the repository and install dependencies:

git clone https://github.com/MadaraUchiha-314/skillbot.git
cd skillbot
uv sync --dev

This creates a .venv virtual environment and installs all runtime and dev dependencies.

Installing Pre-commit Hooks

Pre-commit hooks run linting, type checking, unit tests, and commit message validation automatically on every commit. Install them with:

uv run pre-commit install
uv run pre-commit install --hook-type commit-msg

You can also run all hooks manually against the entire codebase:

uv run pre-commit run --all-files

Common Commands

# Run unit tests
uv run pytest

# Run linter
uv run ruff check .

# Auto-fix lint issues
uv run ruff check . --fix

# Format code
uv run ruff format .

# Run type checker
uv run mypy skillbot

# Run all pre-commit hooks
uv run pre-commit run --all-files

Commit Messages

This project follows Conventional Commits. Commit messages are validated by Commitizen via a commit-msg hook. Use the format:

<type>(<optional scope>): <description>

[optional body]

[optional footer]

Examples:

feat: add user authentication
fix(parser): handle empty input gracefully
docs: update README with setup instructions

Project Structure

skillbot/
├── skillbot/           # Package source code
│   ├── __init__.py
│   └── hello.py
├── tests/              # Test suite
│   └── test_hello.py
├── docs/               # Documentation
├── .github/workflows/  # CI/CD pipelines
│   ├── pr.yml          # Runs on pull requests
│   └── release.yml     # Runs on merge to main
├── pyproject.toml      # Project & tool configuration
└── .pre-commit-config.yaml