Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bighardperson avatar

Tapd Openapi

bighardperson/computer-science-skills-collection

  • 8 installs
  • 33 repo stars
  • Updated April 26, 2026
  • bighardperson/computer-science-skills-collection

TAPD OpenAPI is a Claude Code skill that operates the TAPD project-management platform via its HTTP API to manage stories, bugs, tasks, iterations, wiki, comments, timesheets, and attachments.

About

TAPD OpenAPI is a Claude Code skill that operates the TAPD project-management platform through its HTTP API. It covers requirements (stories), bugs, tasks, iterations, wiki (with local full-text search), comments, timesheets, and attachments, driven by bundled reference docs and Bearer-token curl templates. A developer uses it to query, create, update, or roll up TAPD items from an agent, including across multiple workspaces.

  • Wraps the TAPD OpenAPI for stories, bugs, tasks, iterations, wiki, comments, timesheets, and attachments
  • Uses bundled per-service API reference docs and Bearer-token curl templates
  • Handles multiple workspaces via TAPD_WORKSPACE_IDS with per-ID aggregation

Tapd Openapi by the numbers

  • 8 all-time installs (skills.sh)
  • Ranked #2,242 of 3,280 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Jul 30, 2026 (Skillselion catalog sync)
At a glance

tapd-openapi capabilities & compatibility

Free skill; requires a TAPD account, API endpoint, and token

Capabilities
project management · planning
Use cases
project management · planning
Runs
Runs locally
Pricing
Bring your own API key
Requires keys
TAPD_TOKEN
From the docs

What tapd-openapi says it does

TAPD OpenAPI skill，用于需求、缺陷、任务、迭代、Wiki、评论、工时、附件等 TAPD 平台操作。
SKILL.md
TAPD API 不支持 Wiki 全文搜索，通过本地脚本实现。
SKILL.md
`TAPD_TOKEN` - 认证 Token（Bearer 方式）
SKILL.md
npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill tapd-openapi

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs8
repo stars★ 33
Last updatedApril 26, 2026
Repositorybighardperson/computer-science-skills-collection ↗

What it does

Query, create, and update TAPD stories, bugs, tasks, iterations, and wiki via its OpenAPI.

Who is it for?

Automating TAPD story/bug/task/iteration and timesheet operations from an agent, including multi-workspace rollups.

Skip if: Non-TAPD trackers like Jira or Linear, or platforms without a TAPD token configured.

When should I use this skill?

A user references TAPD, or needs to query, create, update, or count stories, bugs, tasks, iterations, or wiki.

What you get

Programmatic create/query/update/rollup of TAPD work items through authenticated API calls.

By the numbers

  • covers 9 TAPD service groups (stories, bugs, iterations, tasks, comments, wikis, timesheets, attachments, users)

Files

SKILL.mdMarkdownGitHub ↗

TAPD OpenAPI

环境变量（已预置）

  • TAPD_API_ENDPOINT - API 地址, 如果 TAPD_API_ENDPOINT 已配置，则优先使用 TAPD_API_ENDPOINT 的替换文档中的 ${TAPD_API_ENDPOINT}
  • TAPD_WORKSPACE_IDS - 项目 ID 列表，逗号分隔，优先级高于 TAPD_WORKSPACE_ID
  • TAPD_WORKSPACE_ID - 单个项目 ID（兼容旧配置）
  • TAPD_TOKEN - 认证 Token（Bearer 方式）

Workspace 处理规则

调用前必须先确定实际使用的 workspace 列表：

# 优先取 TAPD_WORKSPACE_IDS，回退到 TAPD_WORKSPACE_ID
if [ -n "$TAPD_WORKSPACE_IDS" ]; then
  WS_LIST=$(echo "$TAPD_WORKSPACE_IDS" | tr ',' ' ')
else
  WS_LIST="$TAPD_WORKSPACE_ID"
fi
  • 若 WS_LIST 只有一个 ID，按单 workspace 正常请求即可
  • 若有多个 ID，需对每个 ID 分别调用 API，再汇总结果（求和、合并列表等，根据用户意图决定）
  • 注意 curl 的时候 workspace_id 用逗号分隔后的，例如 $TAPD_WORKSPACE_IDS 是 "31372104,68119668"，则 curl 的时候需要分别调用 workspace_id=31372104 和 workspace_id=68119668

请求模板

# GET
curl -s -H "Authorization: Bearer $TAPD_TOKEN" \
  "${TAPD_API_ENDPOINT}/${path}?workspace_id=${ws_id}"

# POST
curl -s -X POST -H "Authorization: Bearer $TAPD_TOKEN" \
  -H "Content-Type: application/json" \
  "${TAPD_API_ENDPOINT}/${path}" \
  -d '{"workspace_id":"'"${ws_id}"'","key":"value"}'

查询 API 文档

API 文档位于 ~/.codebuddy/skills/tapd-openapi/references/ 目录。

1. 列出所有服务：

ls ~/.codebuddy/skills/tapd-openapi/references/

2. 列出服务下的 API：

ls ~/.codebuddy/skills/tapd-openapi/references/stories/

3. 查看 API 详情：

cat ~/.codebuddy/skills/tapd-openapi/references/stories/liststories.md

常用服务

服务说明常用 API 文件
stories需求管理liststories, countstories, addstory, updatestory, getrelatedbugs, getstoryfieldsinfo
bugs缺陷管理listbugs, countbugs, addbug, updatebug, getbugfieldsinfo
iterations迭代管理listiterations
tasks任务管理listtasks, counttasks, addtask, updatetask
comments评论管理listcomments, countcomments, addcomment
wikisWiki 管理listwikis, countwikis, addwiki, updatewiki, searchwiki（见下方）
timesheets工时花费listtimesheets, counttimesheets, addtimesheet, updatetimesheet
attachments附件管理listattachments, downloadattachment, getimage, downloaddocument
users用户信息getuserinfo, listworkspaces

调用流程

1. 确定服务：根据需求从常用服务中选择，或用 ls 查看全部 2. 查找 API：用 ls ~/.codebuddy/skills/tapd-openapi/references/{服务}/ 找到具体操作 3. 获取详情：用 cat 读取 API 文档，获取请求方法、路径、参数 4. 执行请求：按模板构造 curl 命令，workspace_id 必传

Wiki 搜索

TAPD API 不支持 Wiki 全文搜索，通过本地脚本实现。详见：

cat ~/.codebuddy/skills/tapd-openapi/references/wikis/searchwiki.md

Related skills

mattpocockGrill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.691k196kmattpocockGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.585k196kopen.feishu.cnLark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.493kopen.feishu.cnLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.493kopen.feishu.cnLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).493kopen.feishu.cnLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.493k

FAQ

What does it need to authenticate?

A TAPD_TOKEN Bearer token plus TAPD_API_ENDPOINT and one or more workspace IDs (TAPD_WORKSPACE_IDS or TAPD_WORKSPACE_ID).

Can it search wikis?

Yes, but since the TAPD API lacks full-text wiki search, it uses a local script for searchwiki.

Productivity & Planningpmworkflow
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.