writing-friday-python-agents

Author Friday Python user agents with platform-compliant decorators and I/O routing.

97|5|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/friday-platform/friday-studio --skill writing-friday-python-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-friday-python-agents
Source: https://github.com/friday-platform/friday-studio/tree/main/packages/system/skills/writing-friday-python-agents
Command: npx skills add https://github.com/friday-platform/friday-studio --skill writing-friday-python-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the guesswork and common errors developers face when authoring Friday Python user agents, ensuring agents follow platform conventions, route I/O correctly through host capabilities, and execute reliably in the Friday runtime.

Core Features & Use Cases

  • Complete Authoring Workflow: Covers every step of building a Friday Python user agent, from configuring the mandatory @agent decorator with id, version, and description to implementing the execute function and adding the required run() entry point for NATS communication.
  • Host Capability Integration: Provides detailed guidance for leveraging AgentContext features including LLM generation, outbound HTTP requests, MCP tool calls, progress streaming, and structured input parsing from both signal payloads and upstream workflow step outputs.
  • Best Practices & Troubleshooting: Includes a full API reference, annotated examples ranging from simple echo agents to complex multi-operation agents with upstream input handling, and a comprehensive guide to common mistakes, casing conventions, and platform constraints.
  • Use Case: A developer building a GitHub PR review agent can use this Skill to correctly configure MCP access to GitHub, parse structured operation requests from prompts, emit progress updates to the UI during long-running analysis, and avoid common errors like missing run() entry points or direct API calls that bypass host credential management.

Quick Start

Use this skill to author a new Friday Python user agent that adheres to platform conventions, leverages host capabilities for all I/O, and executes reliably in the Friday runtime.

Frequently Asked Questions about writing-friday-python-agents

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

FAQPage Schema
How do I build a Python agent for the Friday platform?

Use AgentContext capabilities to handle LLM generation, outbound HTTP requests, and MCP tool calls, ensuring all I/O routes through host capabilities for reliable Friday runtime execution.

How does AgentContext work for LLM integration and MCP tool orchestration?

It ensures agents route I/O correctly through host capabilities, bypassing direct API calls to maintain credential management and platform execution conventions.

Why does my Friday Python agent fail without a run() entry point?

This is a common authoring mistake alongside direct API calls that bypass host credential management, which the platform constraints explicitly prohibit.

Can I use MCP tools and external API integration in a Friday Python agent?

This enables use cases like GitHub PR review agents that parse structured operation requests and emit progress updates during long-running analysis.

What are the common mistakes when authoring Friday Python agents?

The Skill provides a comprehensive troubleshooting guide covering these errors, casing conventions, and structured input parsing from upstream workflow step outputs.

Do I need Python to develop agents for the Friday platform?

The Skill specifically applies to Python agents, ensuring compliance with platform execution and I/O routing conventions for production-ready deployment.