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.