agentsclimarketplace
Sign in

Task api helper

Skill tkubica12/skills-demo-catalog/skills/task-api-helper

Helper skill for teams using the shared Task API REST service and its task_cli.py wrapper. Use when the user needs to interact with project tasks: list tasks, filter them by status, fetch task details, add comments, and work within the current shared Task API workflow. The skill knows the API contract, CLI command set, and the improvement process for proposing upstream enhancements when teams discover repetitive or awkward workflows.From its SKILL.md

Install
npx -y skills add tkubica12/skills-demo-catalog --skill task-api-helper

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.2 KB, 624 tokens by cl100k_base, as published. Nobody here has run it

task-api-helper

Overview

This skill helps you work with the Task API — a shared REST service for project task management — and its companion CLI wrapper task_cli.py. Use this skill when you need to:

  • Query or update project tasks via the REST API
  • Run the task_cli.py wrapper commands
  • Understand the current shared Task API workflow
  • Navigate the improvement process to propose a new command upstream

Environment Setup

# Preferred: configure the installed skill locally
cp .env.example .env

# Then edit .env
TASK_API_URL="https://tasks.internal.example.com"

# Optional: authentication token
TASK_API_TOKEN="<your-token>"

The installed skill reads configuration in this order:

  1. --api-url / --token
  2. .env in the installed skill folder
  3. shell environment variables

Using .env in the installed skill folder is the preferred demo setup because the agent may execute in a different shell than the one where environment variables were exported.

Supported CLI Commands

list-tasks

python task_cli.py list-tasks [--status <status>] [--api-url <url>]

Lists all tasks. Use --status to filter by any status value the API supports, for example waiting-for-response or resolved. Omit --status to return all tasks.

get-task

python task_cli.py get-task TASK_ID [--api-url <url>]

Fetches a single task by ID including its comment thread.

add-comment

python task_cli.py add-comment TASK_ID "Your comment text" [--api-url <url>]

Appends a comment to a single task. The comment text is a positional argument.

Workflow evolution

This skill is intentionally centrally maintained. If you discover that a common workflow feels repetitive, awkward, or missing a useful higher-level command, do not jump straight to an upstream issue.

First:

  1. try a temporary local proof of concept in the current repo
  2. verify whether it actually helps
  3. capture the exact command or behavior you tested
  4. remove the local patch

Only then open an enhancement issue in the catalog repository using the Task API Enhancement template. See references/IMPROVEMENT-PROCESS.md for the full flow.

Quick Diagnostics

# Verify CLI is functional
python task_cli.py --help

# List tasks waiting for a response using the configured .env / --api-url / env var
python task_cli.py list-tasks --status waiting-for-response

Improvement Requests

This skill is centrally maintained. Proposed enhancements should be backed by a short local proof of concept in the consumer repo before an upstream issue is opened. Reference the issue number in any PR that implements the change. See references/IMPROVEMENT-PROCESS.md for the full lifecycle.

What ships with it: 4 files

15.6 KB alongside SKILL.md, 1 of them executable

references/

scripts/

Keep looking

Skills are one crate of 326,401. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.