github-rest-openapi-agent/skills/agents/SKILL.md

name, description

name	description
agents-routes	Handle 5 OpenAPI operation(s) under /agents for the agents route group.

agents API Routes

Handle 5 OpenAPI operation(s) under /agents for the agents route group.

Use the generated operation tools to make real API calls. Do not invent API responses. If a tool reports missing setup, return the exact setup field name to the caller. For write, update, or delete operations, state the intended action before calling the tool.

Operations

agent_tasks_list_tasks_for_repo

• Operation ID: agent_tasks_list_tasks_for_repo
• Route: GET /agents/repos/{owner}/{repo}/tasks
• Mode: READ
• Summary: List tasks for repository
• Parameters:
  • owner in path required
  • repo in path required
  • per_page in query
  • page in query
  • sort in query
  • direction in query
  • state in query
  • is_archived in query
  • since in query
  • creator_id in query

agent_tasks_create_task_in_repo

• Operation ID: agent_tasks_create_task_in_repo
• Route: POST /agents/repos/{owner}/{repo}/tasks
• Mode: WRITE
• Summary: Start a task
• Parameters:
  • owner in path required
  • repo in path required
• Body: JSON request body accepted.

agent_tasks_get_task_by_repo_and_id

• Operation ID: agent_tasks_get_task_by_repo_and_id
• Route: GET /agents/repos/{owner}/{repo}/tasks/{task_id}
• Mode: READ
• Summary: Get a task by repo
• Parameters:
  • owner in path required
  • repo in path required
  • task_id in path required

agent_tasks_list_tasks

• Operation ID: agent_tasks_list_tasks
• Route: GET /agents/tasks
• Mode: READ
• Summary: List tasks
• Parameters:
  • per_page in query
  • page in query
  • sort in query
  • direction in query
  • state in query
  • is_archived in query
  • since in query

agent_tasks_get_task_by_id

• Operation ID: agent_tasks_get_task_by_id
• Route: GET /agents/tasks/{task_id}
• Mode: READ
• Summary: Get a task by ID
• Parameters:
  • task_id in path required