youtrack-digisal_skill

Overview

This skill lets you interact with YouTrack via its REST API to read projects and issues, create or update tasks, manage knowledge base articles, and generate client invoices from time tracking. It provides a Python client and CLI scripts for common workflows so you can automate reporting, billing, and issue management. Authentication uses a permanent API token and the invoice generator supports configurable hourly rates.

How this skill works

The skill wraps YouTrack REST endpoints in a Python YouTrackAPI class to fetch projects, issues, work items, and knowledge base articles, and to create or update issues and articles. An InvoiceGenerator consumes work item data, aggregates time per issue, applies rounding and minimum-charge rules, and produces plain-text invoices. CLI scripts expose list, get, create, and invoice workflows for quick usage from the terminal.

When to use it

• Automate retrieval of projects, issues, and work items for reporting or synchronization.
• Create or update issues programmatically from other tools or deployment hooks.
• Generate client invoices from tracked time with consistent rounding and minimum charges.
• Export knowledge base articles or manage documentation across projects.
• Run quick CLI queries to find issues by query, assignee, or update date.

Best practices

• Use a permanent API token stored in the YOUTRACK_TOKEN environment variable rather than passing tokens on the command line.
• Configure the hourly rate explicitly when generating invoices to match client billing agreements.
• Test queries in a staging instance before running destructive create/update operations.
• Inspect stderr for API error details and handle network or auth errors in automation scripts.
• Export invoice text and convert to PDF for client delivery to preserve formatting.

Example use cases

• List all projects to build a dashboard of active work across teams.
• Query issues updated since a date to produce weekly change reports.
• Create issues from automated monitors or customer feedback systems.
• Generate a monthly invoice for a client project by aggregating tracked time.
• Pull knowledge base articles to populate an external documentation site.