Praison AI

Get Started

SkillsConfig

Configure agent skills discovery and loading

Next

Configure how agents discover and load reusable skills from directories and paths.

Diagram

Skills System

📁 Paths

🔍 Discover

📦 Load

🤖 Agent

Quick Start

  1. Simple List

    Pass skill paths directly:

    python
    from praisonaiagents import Agent

agent = Agent(
    name="Skilled Agent",
    instructions="Use these skills",
    skills=["./my-skill", "code-review"]
)
  2. With Configuration

    Configure skill discovery:

    python
    from praisonaiagents import Agent
from praisonaiagents.config import SkillsConfig

agent = Agent(
    name="Skilled Agent",
    instructions="Use these skills",
    skills=SkillsConfig(
        paths=["./my-skill"],
        dirs=["~/.praisonai/skills/"],
        auto_discover=True
    )
)

Configuration Options

python
from praisonaiagents.config import SkillsConfig

config = SkillsConfig(
    # Direct skill paths
    paths=[],

    # Directories to scan
    dirs=[],

    # Auto-discover from defaults
    auto_discover=False
)
ParameterTypeDefaultDescription
pathsList[str][]Direct paths to skill folders
dirsList[str][]Directories to scan for skills
auto_discoverboolFalseAuto-discover from default locations

Common Patterns

Pattern 1: Project Skills

python
from praisonaiagents import Agent
from praisonaiagents.config import SkillsConfig

agent = Agent(
    name="Project Agent",
    instructions="Use project skills",
    skills=SkillsConfig(
        paths=["./skills/code-review", "./skills/testing"]
    )
)

Pattern 2: Global Skills Directory

python
from praisonaiagents import Agent
from praisonaiagents.config import SkillsConfig

agent = Agent(
    name="Global Agent",
    instructions="Use global skills",
    skills=SkillsConfig(
        dirs=["~/.praisonai/skills/"],
        auto_discover=True
    )
)

Pattern 3: Mixed Sources

python
from praisonaiagents import Agent
from praisonaiagents.config import SkillsConfig

agent = Agent(
    name="Mixed Agent",
    instructions="Use all available skills",
    skills=SkillsConfig(
        paths=["./local-skill"],
        dirs=["~/.praisonai/skills/", "/shared/skills/"],
        auto_discover=True
    )
)

Best Practices

Use Paths for Specific Skills

Use paths when you know exactly which skills to load.

Use Dirs for Skill Libraries

Use dirs to manage collections of related skills.

Enable Auto-Discover for Development

Enable auto_discover during development to find available skills.

Related

Skills

Learn about the skills system

 Tool Config

Configure agent tools