> ## 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**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/models.md) module.

AI Agent

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

**name** `str`

No description available.

**description** `str`

No description available.

**license** `Optional[str]`

No description available.

**compatibility** `Optional[str]`

No description available.

**allowed\_tools** `Optional[object]`

No description available.

**metadata** `dict`

No description available.

**path** `Optional[Path]`

No description available.

**when\_to\_use** `Optional[str]`

No description available.

**disable\_model\_invocation** `bool`

No description available.

**user\_invocable** `bool`

No description available.

**argument\_hint** `Optional[str]`

No description available.

**model** `Optional[str]`

No description available.

**effort** `Optional[str]`

No description available.

**context** `Optional[str]`

No description available.

**agent** `Optional[str]`

No description available.

**hooks** `Optional[dict]`

No description available.

**paths** `Optional[object]`

No description available.

**shell** `Optional[str]`

No description available.

**requirements** `Optional[SkillRequirements]`

No description available.

**automation** `Optional[SkillAutomation]`

No description available.

**agent\_created** `bool`

No description available.

**created\_at** `Optional[str]`

No description available.

**use\_count** `int`

No description available.

**last\_used** `Optional[str]`

No description available.

**patch\_count** `int`

No description available.

## Methods

> [card] [idle\_days()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/SkillProperties-idle_days.md)
>
> Days since the skill was last used (or created if never used).

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

## Source

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

***

## 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.