github/penpot
1
0
Fork 0
mirror of https://github.com/penpot/penpot.git synced 2026-05-26 10:23:45 +00:00
Code Issues Packages Projects Releases Wiki Activity
penpot/.opencode/skills/taiga/SKILL.md
Andrey Antukh 0b65431137 📎 Add taiga skill and script for opencode 
Allows easy extraction of information from taiga urls
2026-05-15 11:10:02 +02:00

2.9 KiB
Raw Blame History

name, description, metadata
name description metadata
taiga Fetch information from Taiga public API for the Penpot project (id 345963) — issues, user stories, and tasks, without authentication.
clawdbot
requires
bins
python3

Taiga API Skill

Fetch information from Taiga public API for the Penpot project (project id: 345963, slug: penpot).

No authentication required — only public project data is accessed.

Prerequisites

  • python3 — the tools/taiga.py CLI script is self-contained (stdlib only)

Quick Start

The easiest way is to use the bundled Python script:

# Pass a Taiga URL directly
python3 tools/taiga.py https://tree.taiga.io/project/penpot/issue/13714

# Or use "<type> <ref>" syntax
python3 tools/taiga.py us 14128
python3 tools/taiga.py task 13648

# Add --json for raw output
python3 tools/taiga.py --json issue 13714

# See full usage
python3 tools/taiga.py --help

URL Pattern Reference

Taiga web URLs follow these patterns:

Type Web URL Pattern
Issue https://tree.taiga.io/project/penpot/issue/<REF>
User Story https://tree.taiga.io/project/penpot/us/<REF>
Task https://tree.taiga.io/project/penpot/task/<REF>

To extract the type and ref from a URL:

  • issue/13714 → type=issue, ref=13714
  • us/14128 → type=us, ref=14128
  • task/13648 → type=task, ref=13648

Python Script Reference

The tools/taiga.py script wraps the Taiga API into a single convenient CLI with sensible defaults.

Usage

python3 tools/taiga.py <taiga-url>
python3 tools/taiga.py <type> <ref>
python3 tools/taiga.py [--json] <taiga-url>
python3 tools/taiga.py [--json] <type> <ref>

Examples

# By URL (recommended — no need to think about type/ref)
python3 tools/taiga.py https://tree.taiga.io/project/penpot/issue/13714

# By type and ref
python3 tools/taiga.py us 14128
python3 tools/taiga.py task 13648

# Raw JSON output
python3 tools/taiga.py --json issue 13714

Output

The script prints a clean, structured summary:

User Story #11964 — 🔴 [DESIGN TOKENS] Typography Composite Input
================================
Status:     Defining
Milestone:  design-systems-sprint-26
Points:     3 role(s)
Assignee:   Natacha Menjibar
Author:     Natacha Menjibar
Created:    2025-09-01
Tags:       iop-design-tokens
URL:        https://tree.taiga.io/project/penpot/us/11964
================================
<full description text, unmodified>

The fields section includes type-specific information:

  • Issues: Status, Type ID, Severity ID, Priority ID
  • User Stories: Status, Milestone, Points
  • Tasks: Status, Milestone, Parent US

Reference