Tapd Openapi

What it does

When your agent uses it

• Tasks that involve OpenAPI specifications
• Tasks that involve Time tracking and reporting

Example prompts

• “/tapd-openapi”

Requirements

• A credential in TAPD_TOKEN
• Pre-approved tools (allowed-tools): Bash, Read, Glob, Grep

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

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

What it can do on your machine

Read from SKILL.md and the folder at commit 9830caf. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash
  • Read
  • Glob
  • Grep

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/, which the agent can run.

  Shell commands in SKILL.md call:

  • curl

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • TAPD_TOKEN

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tapd Openapi loads about 769 tokens when it runs, and up to ~27k if it reads all its reference files. Until then it costs about 69 tokens; SKILL.md has 158 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~69

When it runs · the whole SKILL.md, loaded when a task matches

~769

With references · SKILL.md plus every file in references/, read only if the agent opens them

~27k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Bash, Read, Glob, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 158 words (~769 tokens).

name

tapd-openapi

allowed-tools

Bash, Read, Glob, Grep

version

1.0.3

description_zh

TAPD 项目管理平台操作（需求、缺陷、任务、迭代、Wiki）

description_en

TAPD project management (stories, bugs, tasks, iterations, wiki)

display_name

tapd-openapi

display_name_en

tapd-openapi

visibility

public

Read the full SKILL.md on GitHub

Files

SKILL.md and 44 other files (scripts, references) in skills/tapd-openapi of infometa/workbuddyskills.

• SKILL.md
• README.md
• hooks/hooks.json
• references/attachments/downloadattachment.md
• references/attachments/downloaddocument.md
• references/attachments/getimage.md
• references/attachments/listattachments.md
• references/bugs/addbug.md
• references/bugs/countbugs.md
• references/bugs/getbugfieldsinfo.md
• references/bugs/listbugs.md
• references/bugs/updatebug.md
• references/comments/addcomment.md
• references/comments/countcomments.md
• references/comments/listcomments.md
• references/iterations
• … and 29 more

Open the folder on GitHubat commit 9830caf