SkillsConfig - PraisonAI

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

Quick Start

Simple List

Pass skill paths directly:

from praisonaiagents import Agent

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

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
)

Parameter	Type	Default	Description
`paths`	`List[str]`	`[]`	Direct paths to skill folders
`dirs`	`List[str]`	`[]`	Directories to scan for skills
`auto_discover`	`bool`	`False`	Auto-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 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.

Skills

Learn about the skills system

Tool Config

Configure agent tools

HooksConfig

AutonomyConfig

​Quick Start

​Configuration Options

​Common Patterns

​Pattern 1: Project Skills

​Pattern 2: Global Skills Directory

​Pattern 3: Mixed Sources

​Best Practices

​Related