Andrey Antukh f3bf24b4f6 ♻️ Consolidate dev tooling into scripts/ and reorganize docs
Move all development tools from tools/ to scripts/ for consistency.
Rename lint/fmt/check-fmt to lint-clj/fmt-clj/check-fmt-clj to clarify
they target Clojure specifically. Remove unused scripts (attach-opencode,
start-opencode, start-opencode-server) and the backport-commit skill.

Update all internal references across .serena/, AGENTS.md, and
CONTRIBUTING.md to point to the new script locations. Simplify
CONTRIBUTING.md by delegating module-specific fmt/lint instructions
to the respective serena memories.

AI-assisted-by: deepseek-v4-flash
2026-07-22 09:18:06 +02:00

2.9 KiB

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 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:

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

Reference