Agent Skills › penpot/penpot › taiga

taiga

GitHub

通过Python CLI脚本查询Penpot项目在Taiga上的Issue、User Story和Task等公开信息，支持URL解析与结构化输出。

.opencode/skills/taiga/SKILL.md penpot/penpot

触发场景

用户需要获取特定Taiga任务或问题的详情用户希望将Taiga URL转换为结构化数据

安装

npx skills add penpot/penpot --skill taiga -g -y

更多选项

非标准路径

npx skills add https://github.com/penpot/penpot/tree/develop/.opencode/skills/taiga -g -y

不安装直接使用

npx skills use penpot/penpot@taiga

指定 Agent (Claude Code)

npx skills add penpot/penpot --skill taiga -a claude-code -g -y

安装 repo 全部 skill

npx skills add penpot/penpot --all -g -y

预览 repo 内 skill

npx skills add penpot/penpot --list

SKILL.md

Frontmatter

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

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 scripts/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 scripts/taiga.py https://tree.taiga.io/project/penpot/issue/13714

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

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

# See full usage
python3 scripts/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 scripts/taiga.py script wraps the Taiga API into a single convenient CLI with sensible defaults.

Usage

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

Examples

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

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

# Raw JSON output
python3 scripts/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: