Skillfile: A Declarative Manager for AI Skills and Agents

Skillfile serves as a declarative management tool designed to simplify the installation and management of AI skills and agents, akin to the Brewfile but tailored for AI tooling. Currently, it integrates seamlessly with platforms such as Claude Code, Gemini CLI, and Codex.

With the increase in community-created skills and agents available across various platforms, managing their installation can become cumbersome. Often, the typical process involves using npx one-liners, copy-pasting markdown files, or running specific plugins, which can lead to untracked installations and an inability to easily update or customize skills. Skillfile addresses these pain points by providing a single configuration file called Skillfile that declares all requirements in a straightforward line-oriented format.

Key Features:

• Centralized Management: Utilize a single command to install and manage skills and agents with skillfile install. The tool fetches the specified skills and agents directly and locks them to precise commit SHAs, ensuring a reproducible setup.
• Customizable Skills: Edits made to installed skills can be preserved using the skillfile pin command, capturing changes as a patch. This allows users to update their skills while retaining custom modifications.
• User-Friendly Configuration: The configuration file is line-oriented, human-readable, and requires no complex formats like YAML or TOML. Users can easily add new entries using commands such as skillfile add.

Usage Example:

To quickly set up your environment, follow these commands:

# Initialize and create Skillfile
skillfile init

# Add skills and agents to your configuration
skillfile add github skill obra/superpowers skills/requesting-code-review
skillfile add github agent iannuttall/claude-agents agents/code-refactorer.md

Skillfile Format:

The Skillfile format supports various installation entries including GitHub, local, and URL sources, allowing for extensive flexibility in managing AI resources. Here’s an example of a Skillfile entry:

# Platform targeting
install  claude-code  global
install  gemini-cli   local

# Adding skills and agents
github  agent  VoltAgent/awesome-claude-code-subagents  categories/01-core-development/backend-developer.md

Supported Command Functions:

• Setup: Commands include init, add, and remove for managing the configuration.
• Workflow Commands: Execute installations, sync actions, and check the status of entries.
• Validation and Customization: Validate entries for errors and customize installations with patching options.

The tool emphasizes security by allowing users to review what is installed, as it downloads content from specified sources without analyzing or sandboxing the content. A lock file ensures reproducibility, while a configured environment variable system enhances usability and control over the installation process.

Skillfile provides a robust solution for managing AI skills and agents, streamlining the workflow for developers and AI enthusiasts seeking a reliable way to maintain their toolset.