# Send YouTrack Project Management to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "youtrack-digisal", "name": "YouTrack Project Management", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/digiSal/youtrack-digisal", "canonicalUrl": "https://clawhub.ai/digiSal/youtrack-digisal", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/youtrack-digisal", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=youtrack-digisal", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "REFERENCES.md", "SKILL.md", "scripts/invoice_generator.py", "scripts/youtrack_api.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/youtrack-digisal" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/youtrack-digisal", "downloadUrl": "https://openagent3.xyz/downloads/youtrack-digisal", "agentUrl": "https://openagent3.xyz/skills/youtrack-digisal/agent", "manifestUrl": "https://openagent3.xyz/skills/youtrack-digisal/agent.json", "briefUrl": "https://openagent3.xyz/skills/youtrack-digisal/agent.md" } } ``` ## Documentation ### YouTrack YouTrack integration for project management, time tracking, and knowledge base. ### Authentication To generate a permanent token: From the main navigation menu, select Administration > Access Management > Users Find your user and click to open settings Generate a new permanent API token Set the token as an environment variable: export YOUTRACK_TOKEN=your-permanent-token-here Important: Configure your hourly rate (default $100/hour) by passing --rate to invoice_generator.py or updating hourly_rate parameter in your code. Then use any YouTrack script: # List all projects python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-projects # List issues in a project python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-issues "project: MyProject" # Generate invoice for a project python3 scripts/invoice_generator.py --url https://your-instance.youtrack.cloud --project MyProject --month "January 2026" --from-date "2026-01-01" ### scripts/youtrack_api.py Core API client for all YouTrack operations. In your Python code: from youtrack_api import YouTrackAPI api = YouTrackAPI('https://your-instance.youtrack.cloud', token='your-token') # Projects projects = api.get_projects() project = api.get_project('project-id') # Issues issues = api.get_issues(query='project: MyProject') issue = api.get_issue('issue-id') # Create issue api.create_issue('project-id', 'Summary', 'Description') # Work items (time tracking) work_items = api.get_work_items('issue-id') issue_with_time = api.get_issue_with_work_items('issue-id') # Knowledge base articles = api.get_articles() article = api.get_article('article-id') api.create_article('project-id', 'Title', 'Content') CLI usage: python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud \\ --token YOUR_TOKEN \\ --list-projects python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud \\ --get-issue ABC-123 python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud \\ --get-articles ### scripts/invoice_generator.py Generate client invoices from time tracking data. In your Python code: from youtrack_api import YouTrackAPI from invoice_generator import InvoiceGenerator api = YouTrackAPI('https://your-instance.youtrack.cloud', token='your-token') generator = InvoiceGenerator(api, hourly_rate=100.0) # Get time data for a project project_data = generator.get_project_time_data('project-id', from_date='2026-01-01') # Generate invoice invoice_text = generator.generate_invoice_text(project_data, month='January 2026') print(invoice_text) CLI usage: python3 scripts/invoice_generator.py \\ --url https://your-instance.youtrack.cloud \\ --project MyProject \\ --from-date 2026-01-01 \\ --month "January 2026" \\ --rate 100 \\ --format text Save the text output and print to PDF for clients. ### 1. List All Projects python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-projects ### 2. Find Issues in a Project # All issues in a project python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-issues "project: MyProject" # Issues updated since a date python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-issues "project: MyProject updated >= 2026-01-01" # Issues assigned to you python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-issues "assignee: me" ### 3. Create a New Issue from youtrack_api import YouTrackAPI api = YouTrackAPI('https://your-instance.youtrack.cloud') api.create_issue( project_id='MyProject', summary='Task title', description='Task description' ) ### 4. Generate Monthly Invoice # Generate invoice for January 2026 python3 scripts/invoice_generator.py \\ --url https://your-instance.youtrack.cloud \\ --project ClientProject \\ --from-date 2026-01-01 \\ --month "January 2026" \\ --rate 100 \\ --format text > invoice.txt Save the text output and print to PDF for clients. ### 5. Read Knowledge Base from youtrack_api import YouTrackAPI api = YouTrackAPI('https://your-instance.youtrack.cloud') # All articles articles = api.get_articles() # Articles for specific project articles = api.get_articles(project_id='MyProject') # Get specific article article = api.get_article('article-id') ### Billing Logic Invoice generator uses this calculation: Sum all time tracked per issue (in minutes) Convert to 30-minute increments (round up) Minimum charge is 30 minutes (at configured rate/2) Multiply by rate (default $100/hour = $50 per half-hour) Examples: 15 minutes → $50 (30 min minimum) 35 minutes → $100 (rounded to 60 min) 60 minutes → $100 67 minutes → $150 (rounded to 90 min) ### Environment Variables YOUTRACK_TOKEN: Your permanent API token (recommended over passing as argument) Set with export YOUTRACK_TOKEN=your-token ### API Details See REFERENCES.md for: Complete API endpoint documentation Query language examples Field IDs and structures ### Error Handling Scripts will raise errors for: Missing or invalid token Network issues API errors (404, 403, etc.) Check stderr for error details. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: digiSal - Version: 1.0.1 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-05-07T17:22:31.273Z - Expires at: 2026-05-14T17:22:31.273Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/youtrack-digisal) - [Send to Agent page](https://openagent3.xyz/skills/youtrack-digisal/agent) - [JSON manifest](https://openagent3.xyz/skills/youtrack-digisal/agent.json) - [Markdown brief](https://openagent3.xyz/skills/youtrack-digisal/agent.md) - [Download page](https://openagent3.xyz/downloads/youtrack-digisal)