Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.igent.ai/llms.txt

Use this file to discover all available pages before exploring further.

Extend Maestro with specialized knowledge and capabilities.

​
What Are Skills?

Skills are reusable packages that give Maestro expertise in specific domains, technologies, or workflows. When enabled, they enhance what Maestro knows and what it can do—automatically applying specialized knowledge when relevant to your work. A Skill might contain deep knowledge about a particular framework, systematic approaches to analysis tasks, standards for specific types of work, or new capabilities like browser automation. Skills work in the background, augmenting Maestro’s baseline abilities with domain-specific intelligence.

​
Why Use Skills?

Access Specialized Knowledge Get expert-level guidance without being an expert yourself. Skills encode deep domain knowledge—whether that’s optimization patterns for a framework, best practices for a technology, or systematic approaches to complex analysis. Maestro applies this knowledge automatically as you work. Extend Capabilities Add abilities Maestro doesn’t have by default. Skills can introduce entirely new functionality—from automating specialized analysis to interacting with external systems. This turns Maestro into a platform you can customize for your specific needs. Ensure Systematic Quality Apply standards consistently rather than relying on memory or manual checklists. When a Skill encodes how something should be done, Maestro applies that approach systematically every time—ensuring quality and completeness without requiring you to remember every detail. Save Time on Repeated Tasks Stop explaining the same context, constraints, or standards in every session. Package that knowledge once as a Skill, and Maestro has it available automatically. This is especially valuable for team-wide standards, recurring workflows, or complex domain knowledge that would otherwise need repeated explanation. Share Expertise Across Teams Turn individual expertise into team capability. When someone on your team has deep knowledge in an area, they can package it as a Skill. Now everyone benefits from that expertise without needing to learn it themselves or repeatedly ask questions.

​
How Skills Work

Skills integrate seamlessly into your workflow:
  1. Install: Add a Skill by uploading its package (zip file) to Maestro
  2. Enable: Activate the Skills you want for your current session
  3. Automatic Application: Maestro applies Skills automatically when they’re relevant
You don’t manually invoke Skills. When Maestro detects a Skill is relevant to your current work—based on the files you’re working with, the task you’re doing, or the domain you’re in—it applies that Skill’s knowledge and capabilities automatically.

​
How This Feels in Practice

With Skills enabled, Maestro simply becomes more knowledgeable and capable in those areas. You might notice:
  • Deeper insights: Responses show expertise in specific domains
  • Better suggestions: Recommendations aligned with best practices for that technology
  • Systematic approaches: Complex tasks handled methodically using proven patterns
  • New abilities: Maestro can do things it couldn’t do before (like specialized automation or analysis)
Skills work in the background, so the experience is natural—Maestro just “knows more” about the areas covered by your enabled Skills.

​
Using Skills

​
Upload a Skill

  1. Obtain a Skill package (zip file)
    • Download from your organization’s Skill repository
    • Receive from a team member
    • Acquire from a Skill marketplace
  2. Navigate to the Skills section in Maestro’s web UI
  3. Upload the zip file
  4. The Skill is now available in your account

​
Enable Skills for a Session

Before starting work, enable the Skills you need:
  1. At the start of your session, you’ll see available Skills
  2. Check the box next to each Skill you want to use
  3. Enabled Skills are active for that session
  4. Maestro will automatically apply them when relevant
You can enable or disable Skills at any time during your session.

​
What Skills Can Do

Skills extend Maestro in four primary ways: Provide Domain Expertise Skills can encode deep knowledge about frameworks, technologies, design principles, or specialized fields. This means Maestro can apply expert-level understanding to your work—knowing the nuances, best practices, and common patterns specific to that domain. You get guidance that would otherwise require years of experience. Add New Capabilities Skills can introduce entirely new functionality—like browser automation, specialized analysis, or interaction with external systems. These capabilities aren’t modifications to your code; they’re tools Maestro can use on your behalf to accomplish tasks that would otherwise be impossible or require manual work. Encode Standards and Processes When your team has specific ways of doing things, Skills can capture those approaches systematically. This ensures consistency across sessions and team members—Maestro applies the same logic, checks the same criteria, and follows the same steps every time, without requiring manual checklists or repeated explanation. Automate Specialized Analysis Skills can perform systematic evaluation across multiple dimensions—examining code, content, or systems against known criteria. This turns subjective judgment into repeatable process, with clear findings and actionable recommendations. The analysis happens automatically, consistently, and thoroughly.

​
Common Skill Patterns

While Skills can serve countless purposes, most fall into a few recognizable patterns:

​
Framework and Technology Expertise

Skills that provide deep knowledge about specific frameworks, libraries, or platforms. These help Maestro understand optimization patterns, common pitfalls, architectural best practices, and idioms specific to that technology. You benefit from expert-level guidance without needing to be an expert yourself.

​
Quality and Standards Enforcement

Skills that encode how things should be done in your environment. These systematically check work against defined criteria—whether that’s style guidelines, required elements, or quality thresholds. The Skill ensures nothing is missed and standards are applied consistently.

​
Specialized Automation

Skills that give Maestro new abilities to interact with systems or perform tasks it couldn’t do otherwise. This might be browser automation, integration with specific tools, or specialized forms of analysis. These Skills turn Maestro into a capable automation platform.

​
Systematic Evaluation

Skills that assess quality across multiple dimensions—examining code, design, performance, accessibility, or other attributes against known criteria. These Skills provide comprehensive analysis with prioritized findings, transforming subjective assessment into repeatable process.

​
Workflow and Process Guidance

Skills that capture multi-step procedures specific to your team or domain. These ensure complex workflows are executed completely and in the right order, with all necessary validation and checks. Institutional knowledge becomes systematically applied rather than manually remembered.

​
Skills vs. Prompts

Prompts are instructions you give Maestro in conversation:
  • One-time, specific to current task
  • Require you to remember and articulate each time
  • Limited to current session context
Skills are reusable packages:
  • Applied automatically when relevant
  • Consistent across sessions and team members
  • Can include scripts and reference materials
  • Work in the background without explicit invocation
Use prompts for ad-hoc tasks. Use Skills for recurring processes and standards.

​
Where Skills Come From

Skills exist in a growing open ecosystem: Public Skill Repositories The Skills ecosystem includes publicly available Skills covering common frameworks, technologies, and workflows. Browse available Skills at skills.sh, where you’ll find community-contributed capabilities ranging from framework best practices to specialized automation tools. Your Organization Many teams create internal Skills that capture company-specific knowledge:
  • Standards and conventions unique to your organization
  • Workflows specific to your tooling and infrastructure
  • Domain knowledge relevant to your products or services
Team Members Skills can be created and shared within teams. When someone has expertise in an area, they can package it as a Skill so others benefit without needing to develop that expertise themselves. Custom Creation You can create Skills tailored to your specific needs. The Agent Skills documentation provides comprehensive guidance on Skill authoring.

​
Managing Your Skills

​
Viewing Available Skills

In the Skills section of Maestro’s UI, you can:
  • See all Skills you’ve uploaded
  • View Skill descriptions
  • Check which Skills are enabled for your current session
  • Enable or disable Skills as needed

​
When to Enable Skills

Enable Skills based on the domain and type of work you’re doing: Enable Skills relevant to your current domain: If you’re working with specific technologies or frameworks, enable Skills that provide expertise in those areas. Enable Skills for the standards you need: If there are quality standards, conventions, or processes you want systematically applied, enable those Skills. Enable Skills for specialized capabilities: If your work requires specific automation or analysis that Skills provide, enable those capabilities. You can enable multiple Skills simultaneously—they work together without conflict.

​
Disabling Skills

If a Skill isn’t relevant to your current work, you can disable it:
  • Uncheck the box next to the Skill
  • The Skill won’t be applied for the rest of the session
  • You can re-enable it anytime

​
Best Practices for Using Skills

Enable only relevant Skills: More Skills means more context for Maestro to consider. Enable the ones you need for your current work. Check Skill descriptions: Before enabling, read what each Skill does to ensure it’s appropriate for your task. Update Skills regularly: If your team maintains Skills, make sure you have the latest versions with updated procedures. Provide feedback: If a Skill isn’t working as expected or could be improved, let your team know.

​
Troubleshooting

​
Skill not triggering

If you expected a Skill to apply but it didn’t:
  • Verify the Skill is enabled for your session
  • Check that your task matches the Skill’s description and trigger conditions
  • Try being more explicit about what you’re working on or directly reference the Skill

​
Skill behavior unexpected

If a Skill does something you didn’t expect:
  • Review the Skill’s description to understand its intended behavior
  • Disable the Skill if it’s not appropriate for your current work
  • Contact the Skill author (team member or organization) for clarification

​
Multiple Skills conflicting

If you have overlapping Skills enabled:
  • Maestro will attempt to apply all relevant Skills
  • You can disable one to see if behavior improves
  • Let Skill authors know if there are conflicts that should be resolved

​
Next Steps

Start using Skills to enhance your Maestro workflow:

​
Additional Resources

For information about creating Skills, see the Agent Skills documentation which provides comprehensive guidance on Skill authoring.