> ## 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**](../modules/models) module.

<Badge color="blue">AI Agent</Badge>

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

<ResponseField name="schedule" type="str">
  No description available.
</ResponseField>

<ResponseField name="deliver" type="Optional[str]">
  No description available.
</ResponseField>

<ResponseField name="prompt" type="Optional[str]">
  No description available.
</ResponseField>

## Methods

<CardGroup cols={2}>
  <Card title="from_metadata()" icon="function" href="../functions/SkillAutomation-from_metadata">
    Parse an automation block from a skill's `metadata` mapping.
  </Card>
</CardGroup>

<Accordion title="Internal & Generic Methods">
  * **to\_dict**: Convert to dictionary, excluding None values.
</Accordion>

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/skills/models.py#L146">
  `praisonaiagents/skills/models.py` at line 146
</Card>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Skills Concept" icon="wand-magic-sparkles" href="/docs/docs/concepts/skills" />

  <Card title="Skills Feature" icon="star" href="/docs/docs/features/skills" />
</CardGroup>