Agent Skills

Sypha utilizes Agent Skills, a modular and open format designed to enhance AI reasoning with specialized domain expertise and repeatable technical workflows.

Understanding Agent Skills

Skills serve as "packages" of specialized knowledge and procedural logic. Each skill is contained within a dedicated directory featuring a SKILL.md file. This file provides the AI with the specific instructions and guidelines necessary to execute complex tasks - such as architectural design, security auditing, or performance tuning - with expert-level proficiency.

Strategic Implementation in Sypha

• Cross-Persona Skills: Universally available across all operational modes.
• Mode-Dependent Skills: Intelligently loaded only when Sypha is operating within a specific persona (e.g., Code, Architect, or Debug).

Storage & Hierarchy

• Global Skills Library: Stored at ~/.sypha/skills/ to be accessible across all projects.
• Repository-Specific Skills: Stored at .sypha/skills/ for logic that is unique to a single codebase.

Priority Engine

1. Local Project Skills take precedence over global configurations.
2. Mode-Specific Skills override universal skills when the corresponding persona is active.

Initializing a New Skill

1. Define a dedicated directory: mkdir -p ~/.sypha/skills/api-optimization
2. Initialize a SKILL.md asset with the following YAML metadata:

---
name: api-optimization
description: Advanced strategies for refactoring REST interfaces for peak performance.
---
# Actionable Instructions
Your technical guidelines and step-by-step procedures for the AI agent are defined here.

Cross-Environment Synchronization

You can utilize symbolic links (symlinks) to synchronize skill libraries across different repositories or machines. Ensure the name defined in the metadata matches the directory or symlink identifier exactly for proper resolution.

Validating Skill Availability

You can query Sypha directly to verify your configuration: "Identify your currently active skills" or "Confirm if the 'system-architecture' skill is successfully loaded."

Community Ecosystem

Discover and integrate high-utility, community-developed skills by exploring the Skills Marketplace.