SkillsConfig

Configure agent skills discovery and loading

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
)

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.

---

Related

Skills

Learn about the skills system

Tool Config

Configure agent tools