skillfish  by knoxgraeme

AI coding agent skill manager

Created 4 months ago
252 stars

Top 99.6% on SourcePulse

GitHubView on GitHub
Project Summary

Skillfish is a command-line tool designed to manage "Agent Skills" for AI coding agents, simplifying the installation, updating, and synchronization of these skills across various platforms like Claude Code, Cursor, and GitHub Copilot. It empowers AI agents by providing them with domain expertise, reusable workflows, and team-specific context through portable skill packages, enhancing their capabilities on demand.

How It Works

Skillfish centralizes the management of AI agent skills, which are essentially portable packages containing instructions, prompts, and resources, each anchored by a SKILL.md file. Users can install skills directly from repositories using skillfish add owner/repo. For collaborative environments, the skillfish bundle command generates a skillfish.json manifest file that lists installed skills. This manifest can then be shared and used by team members via skillfish install to synchronize their local skill configurations, ensuring consistency across development teams. Skills can be pinned to specific Git references (tags, branches, or commits) for version control.

Quick Start & Requirements

  • Installation: Install globally for management: npm i -g skillfish. For one-off installations: npx skillfish add owner/repo.
  • Prerequisites: Node.js and npm are required.
  • Resources: Official skill discovery can be found at skill.fish and the MCP Market. Learn more about Agent Skills at agentskills.io.

Highlighted Details

  • Broad compatibility with over 33 AI coding agents, including Claude Code, Cursor, Copilot, Gemini CLI, and more.
  • Facilitates team skill synchronization through skillfish.json manifest files.
  • Supports installation from private GitHub repositories via environment variables or GitHub CLI authentication.
  • Enables creation of new skills using skillfish init, generating a structured template.

Maintenance & Community

The project includes CONTRIBUTING.md, CHANGELOG.md, and SECURITY.md files, indicating structured development practices. Specific community channels (e.g., Discord, Slack) or notable contributors are not detailed in the README.

Licensing & Compatibility

Skillfish is licensed under the AGPL-3.0 license. This strong copyleft license requires derivative works to be made available under the same terms, which may impose restrictions on integration into closed-source commercial products.

Limitations & Caveats

Users are advised to manually review all third-party skills before installation, as skillfish does not vet their content for security or quality. Anonymous telemetry is collected by default but can be opted out via environment variables. The AGPL-3.0 license necessitates careful consideration for commercial adoption or integration.

Health Check
Last Commit

3 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
1
Star History
42 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.