Skip to main content
Configure how agents discover and load reusable skills from directories and paths.

​
Quick Start

1

Simple List

Pass skill paths directly:
from praisonaiagents import Agent

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

With Configuration

Configure skill discovery:
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

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

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

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

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 when you know exactly which skills to load.
Use dirs to manage collections of related skills.
Enable auto_discover during development to find available skills.

Skills

Learn about the skills system

Tool Config

Configure agent tools