Skip to content

Implement skill registry structure with auto-generated index and CI validation#1

Draft
Copilot wants to merge 3 commits into
mainfrom
copilot/update-skill-index-json
Draft

Implement skill registry structure with auto-generated index and CI validation#1
Copilot wants to merge 3 commits into
mainfrom
copilot/update-skill-index-json

Conversation

Copilot AI commented Jan 25, 2026

Copy link
Copy Markdown

Establishes the foundational structure for a centralized skill registry with automated indexing and validation.

Structure

  • skills/ - Registry root with auto-generated index.json catalog
  • scripts/generate-index.js - Scans skill directories, validates metadata, generates sorted index
  • .github/workflows/validate.yml - CI validates JSON schema, required fields, and index freshness
  • README.md - Usage patterns for adding/discovering skills

Skill Format

Each skill lives in skills/<skill-name>/ with:

  • skill.json - Metadata (name, version, description, author, tags, repository)
  • README.md - Documentation

Example:

{
  "name": "example-skill",
  "version": "1.0.0",
  "description": "An example skill demonstrating the skill structure",
  "author": "Refly AI Team",
  "tags": ["example", "demo"],
  "repository": "https://github.com/refly-ai/refly-skills"
}

Validation

Workflow enforces:

  • Valid JSON in all skill.json files
  • Required name field presence
  • Index synchronization with skill directories
  • Read-only GITHUB_TOKEN permissions

Included example-skill/ demonstrates the pattern.

Original prompt

refly-ai/skill-registry/
├── README.md # 仓库介绍、如何使用
├── skills/
│ ├── index.json # 所有 skills 的索引(自动生成)
│ └── /
│ ├── skill.json # 元数据
│ └── README.md # 自动生成的文档
├── .github/
│ └── workflows/
│ └── validate.yml # PR 验证(格式检查)
└── scripts/
└── generate-index.js # 生成 index.json 的脚本


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits January 25, 2026 05:02
Co-authored-by: alchemistklk <56862773+alchemistklk@users.noreply.github.com>
Co-authored-by: alchemistklk <56862773+alchemistklk@users.noreply.github.com>
Copilot AI changed the title [WIP] Update skills index.json for new skill addition Implement skill registry structure with auto-generated index and CI validation Jan 25, 2026
Copilot AI requested a review from alchemistklk January 25, 2026 05:08

@alchemistklk alchemistklk left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved by automation

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants