agently-task-dev

Scaffold Agently tasks with task.py, asgi_app.py, tests, and an offline OpenAI-compatible stub.

50|3|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/okwinds/miscellany --skill agently-task-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agently-task-dev
Source: https://github.com/okwinds/miscellany/tree/main/agent/skills/agently-task-dev
Command: npx skills add https://github.com/okwinds/miscellany --skill agently-task-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill standardizes the process of building task-oriented Agently workflows, providing a production-grade scaffold that includes task execution (run/streaming), a regression-test suite, and an offline OpenAI-compatible stub for validation without external keys.

Core Features & Use Cases

  • Scaffolds a production-ready Agently task with task.py and asgi_app.py, plus an offline stub for tests.
  • Generates a PyTest-based regression harness and an OpenAI-compatible stub to validate streaming, schema, and outputs offline.
  • Provides a service-ready skeleton (ASGI app) for SSE/POST endpoints to prototype deployments and CI-ready workflows.
  • Lets teams adopt a minimal contract (task.py, asgi_app.py, tests) and a scaffold script to bootstrap tests, docs, and CI checks.

Quick Start

Use the scaffold tool to generate a new task and run offline tests: python3 ~/agent/skills/agently-task-dev/scripts/scaffold_task_with_tests.py my_task --out . pytest -q

Frequently Asked Questions about agently-task-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold an Agently task with pytest regression tests?▼

You can scaffold an Agently task with pytest tests by running the scaffold_task_with_tests.py script, which bootstraps task.py, asgi_app.py, and a regression harness. This generates a production-ready task skeleton with CI-ready checks.

Can I validate Agently task streaming outputs offline without an OpenAI API key?▼

Yes, you can validate streaming outputs offline using the included OpenAI-compatible stub. The scaffold generates a stub that mimics API responses, enabling you to test schemas and streaming without external keys.

What is the minimal contract for an Agently task deployment?▼

The minimal contract for an Agently task requires a task.py file for execution logic, an asgi_app.py for service endpoints, and a tests directory. This structure ensures tasks are production-ready with regression validation.

Does this workflow provide an ASGI app skeleton for prototyping SSE endpoints?▼

Yes, the scaffolding process generates an ASGI app skeleton with SSE and POST endpoints. This service-ready file allows you to prototype deployments and integrate CI-ready workflows directly.

How do I bootstrap a CI-ready test suite for an Agently task?▼

You bootstrap a CI-ready test suite by running the scaffold script and then executing pytest -q. The generated PyTest harness uses an offline OpenAI-compatible stub to validate task outputs automatically.