> ## 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 Properties • AI Agent SDK

> SkillProperties: Properties parsed from a skill's SKILL.md frontmatter.

# SkillProperties

> Defined in the [**models**](../modules/models) module.

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

Properties parsed from a skill's SKILL.md frontmatter.

Attributes:
name: Skill name in kebab-case (required)
description: What the skill does and when the model should use it (required)
license: License for the skill (optional)
compatibility: Compatibility information for the skill (optional)
allowed\_tools: Tool patterns the skill requires (optional, experimental)
metadata: Key-value pairs for client-specific properties (defaults to
empty dict; omitted from to\_dict() output when empty)
path: Path to the skill directory (optional, added for PraisonAI)

## Properties

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

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

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

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

<ResponseField name="allowed_tools" type="Optional[object]">
  No description available.
</ResponseField>

<ResponseField name="metadata" type="dict">
  No description available.
</ResponseField>

<ResponseField name="path" type="Optional[Path]">
  No description available.
</ResponseField>

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

<ResponseField name="disable_model_invocation" type="bool">
  No description available.
</ResponseField>

<ResponseField name="user_invocable" type="bool">
  No description available.
</ResponseField>

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

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

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

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

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

<ResponseField name="hooks" type="Optional[dict]">
  No description available.
</ResponseField>

<ResponseField name="paths" type="Optional[object]">
  No description available.
</ResponseField>

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

<ResponseField name="requirements" type="Optional[SkillRequirements]">
  No description available.
</ResponseField>

<ResponseField name="agent_created" type="bool">
  No description available.
</ResponseField>

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

<ResponseField name="use_count" type="int">
  No description available.
</ResponseField>

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

<ResponseField name="patch_count" type="int">
  No description available.
</ResponseField>

## Methods

<CardGroup cols={2}>
  <Card title="idle_days()" icon="function" href="../functions/SkillProperties-idle_days">
    Days since the skill was last used (or created if never used).
  </Card>
</CardGroup>

<Accordion title="Internal & Generic Methods">
  * **to\_dict**: Convert to dictionary, excluding None values and empty metadata.
</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>