Skip to content

feat: support 'Skill-as-Code' directory structure and semantic versioning for external skill imports #540

Description

@FenjuFu

Motivation

The trend of "Skill Standardization" is gaining significant traction in the AI Agent ecosystem. Projects like mattpocock/skills and obra/superpowers are demonstrating that treating skills as modular, version-controlled code units ("Skill-as-Code") drastically improves reusability and collaboration. Meanwhile, Panniantong/Agent-Reach highlights the need for agents to easily discover and consume external data sources.

Currently, iflytek/skillhub excels as an enterprise registry with RBAC and audit logs, but it lacks a standardized ingestion mechanism for these emerging "Skill-as-Code" formats. Developers often have to manually map directory structures or write custom scripts to import skills from GitHub repos or local directories into the registry, which breaks the "local-first" and "git-centric" workflows popular in the open-source community.

Proposed feature

Add a skillhub import CLI command (or a dedicated API endpoint) that supports:

  1. Directory-to-Registry Import: Automatically parse a local directory or a git repository following a standard schema (e.g., manifest.yaml or skill.json at the root) and push the skill package to the registry.
  2. Semantic Versioning (SemVer) Support: Integrate with semantic-release or similar tools to automatically bump versions (major/minor/patch) based on commit history or PR labels during the import/publish process.
  3. Pre-release Tagging: Support alpha, beta, and rc tags to allow enterprises to test new skills in staging environments before promoting them to stable.

Why it fits this repo

iflytek/skillhub is positioned as the "Self-hosted, open-source agent skill registry for enterprises." To become the de-facto enterprise standard for skill governance, it must bridge the gap between open-source "Skill-as-Code" practices and enterprise-grade governance (RBAC, Audit). By supporting standard directory structures and SemVer, SkillHub can act as the central hub for both internal proprietary skills and curated external open-source skills, aligning with the "modular AI" trend.

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    effort/s小改动或边界明确 / Small or well-bounded change.priority/p3低优先级 / Low priority triage bucket.triage/needs-info需要补充更多信息后才能分流 / Issue needs more detail before it can be routed.

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions