Instruction file imported from wow-apps/youtube-id-py (.github/instructions/general.instructions.md). Copyright stays with the author.

General Project Instructions

Name: general
Author: wow-apps

Project Overview

youtube-id is a Python library for generating YouTube-style short IDs from numbers. Lightweight, fast, and reversible base62 encoder with optional obfuscation.

Tech Stack

Python 3.10+
Poetry for dependency management
ruff for linting and formatting
mypy for type checking
pytest for testing
pymarkdownlnt for markdown linting

Quality Requirements

All code must pass automated quality checks before merging:

ruff check . - no linting errors
ruff format --check . - no formatting issues
mypy yid_py/ - no type errors
pytest --cov=yid_py --cov-fail-under=95 - tests pass with 95%+ coverage

Branch Naming

feature/ - new features
fix/ - bug fixes
docs/ - documentation updates
refactor/ - code refactoring
test/ - test additions

PR Title Format

Must start with one of: feature/, fix/, docs/, refactor/, test/ (case-insensitive)

Important Notes

Do NOT suggest changes that conflict with ruff formatting
ruff is the authority for Python code style, not manual preferences
All Python code must have type hints
Zero external dependencies in production code

{ "ocm": "1", "id": "wow-apps-youtube-id-py-general-instructions", "kind": "skill", "name": "general", "description": "youtube-id is a Python library for generating YouTube-style short IDs from numbers. Lightweight, fast, and reversible base62 encoder with optional obfuscation.", "publisher": "wow-apps", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-instructions" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "youtube-id is a Python library for generating YouTube-style short IDs from numbers. Lightweight, fast, and reversible base62 encoder with optional obfuscation." ], "primary": false, "metadata": { "source": { "provider": "github-instructions", "repository": "https://github.com/wow-apps/youtube-id-py", "path": ".github/instructions/general.instructions.md", "ref": "2b6b6c9a00d5fe6b0da256e9601d7c60b9d6dc55", "url": "https://github.com/wow-apps/youtube-id-py/blob/2b6b6c9a00d5fe6b0da256e9601d7c60b9d6dc55/.github/instructions/general.instructions.md", "key": "wow-apps/youtube-id-py/.github/instructions/general.instructions.md" }, "applies_to": "**/*" }, "instructions": "# General Project Instructions\n\n## Project Overview\n\nyoutube-id is a Python library for generating YouTube-style short IDs from numbers.\nLightweight, fast, and reversible base62 encoder with optional obfuscation.\n\n## Tech Stack\n\n- Python 3.10+\n- Poetry for dependency management\n- ruff for linting and formatting\n- mypy for type checking\n- pytest for testing\n- pymarkdownlnt for markdown linting\n\n## Quality Requirements\n\nAll code must pass automated quality checks before merging:\n\n1. `ruff check .` - no linting errors\n2. `ruff format --check .` - no formatting issues\n3. `mypy yid_py/` - no type e", "cost": { "context_tokens": 299 } }

general

About

General Project Instructions

Project Overview

Tech Stack

Quality Requirements

Branch Naming

PR Title Format

Important Notes

Use it

Manifest

Reviews