> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skill Automation • AI Agent SDK

> SkillAutomation: Optional proactive-automation descriptor parsed from a skill's frontmatter.

# SkillAutomation

> Defined in the [**models**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/models.md) module.

AI Agent

Optional proactive-automation descriptor parsed from a skill's frontmatter.

This is a protocol-only contract (no heavy imports): it carries just enough
for a wrapper consumer (the scheduler's consent-first `SuggestionEngine` and
`DeliveryRouter`) to propose and, on user consent, materialise a scheduled,
self-delivering job. Nothing here runs a job or delivers a result — it is the
bridge data that lets an installed skill say "run me on this schedule".

Parsed from `metadata.praisonai.automation` so older parsers ignore it.

Attributes:
schedule: Schedule expression, e.g. "cron:0 8 \* \* mon-fri", "daily",
"\*/30m", "at:\<iso>" (required).
deliver: Delivery target token, e.g. "origin", "\<platform>",
"\<platform>:\<chat>\[:\<thread>]", "all" (optional).
prompt: Task the scheduled run should perform (optional).

## Properties

**schedule** `str`

No description available.

**deliver** `Optional[str]`

No description available.

**prompt** `Optional[str]`

No description available.

## Methods

> [card] [from\_metadata()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillAutomation-from_metadata.md)
>
> Parse an automation block from a skill's `metadata` mapping.

> [accordion] Internal & Generic Methods
>
> * **to\_dict**: Convert to dictionary, excluding None values.

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/skills/models.py#L146)
>
> `praisonaiagents/skills/models.py` at line 146

***

## Related Documentation

> [card] [Skills Concept](https://praison.ai/docs/docs/concepts/skills)

> [card] [Skills Feature](https://praison.ai/docs/docs/features/skills)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.