Skip to content

Redesign Skill system: unified skill package with ZIP download#275

Merged
ShixiangWang merged 3 commits intomainfrom
copilot/redesign-and-implement-skill
Apr 16, 2026
Merged

Redesign Skill system: unified skill package with ZIP download#275
ShixiangWang merged 3 commits intomainfrom
copilot/redesign-and-implement-skill

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 16, 2026

The per-tutorial skill system was unreliable (some pages broken) and fragmented. This replaces it with a single unified Bizard Skill package that users download as a ZIP. Also fixes illegal CSV quoting that GitHub's renderer rejected.

CSV quoting fix

  • Re-wrote files/gallery_data.csv (76 lines) and files/gallery_data_zh.csv (17 lines) with RFC 4180 compliant quoting — fields containing " are now properly enclosed and escaped (e.g. palette="Dark2""palette=""Dark2""").

Unified skill document

  • skill.md is now a proper AI skill instruction document (system-prompt style) that teaches AI assistants how to use Bizard's gallery_data.csv to recommend visualizations and generate reproducible code. It includes: role definition, gallery CSV column reference, 5-step workflow for answering queries, decision guide mapping 17 research goals to visualization types, code conventions for R/Python/Julia, and a structured response format.
  • Auto-generated from skills/index.json via generate_unified_skill() in generate_skills.py, with dynamic counts and categories.
  • Old generation spec preserved as skill-spec.md.

Skill ZIP package contents

  • skill.md — AI skill instructions (the AI's "system prompt")
  • gallery_data.csv — 793 figure examples with image URLs, tutorial links, descriptions, and categories
  • gallery_data_zh.csv — Chinese version of the gallery data
  • README.md — Installation guide for ChatGPT, Claude, GitHub Copilot Chat, and local LLMs (Ollama, LM Studio)

Website UI — per-tutorial modal → ZIP download

  • skill-button.lua: Replaced the per-tutorial fetch/modal/copy flow with a single download link to bizard-skill.zip. Uses runtime JS path resolution to handle both Category/Page.html and zh/Category/Page.html.
  • Skills.qmd / Skills.zh.qmd: Prominent download button with clear description of what the skill does and quick-start instructions. Retained browsable skill grid for reference.

CI coordination

  • quarto-publish.yml: Added post-render step that stages files into a temp directory and creates _site/bizard-skill.zip with clean filenames (including README.md).
  • generate-skills.yml: Now commits skill.md alongside skills/, triggers on skill-spec.md changes.

Copilot AI linked an issue Apr 16, 2026 that may be closed by this pull request
…UI and CI

1. Fix CSV quoting: Properly escape double quotes in gallery_data.csv and
   gallery_data_zh.csv using RFC 4180 compliant format

2. Create unified Bizard Skill: Replace per-tutorial skill.md spec with
   comprehensive unified skill document covering all 257 tutorials across
   13 categories. Old spec renamed to skill-spec.md.

3. Update skill-button.lua: Replace per-tutorial skill modal with unified
   ZIP download button. Uses JavaScript for correct relative path resolution
   across English and Chinese pages.

4. Update Skills.qmd/Skills.zh.qmd: Feature unified skill ZIP download
   prominently with large download button. Keep browsable skill grid for
   reference.

5. Update quarto-publish.yml: Add step to generate bizard-skill.zip
   containing skill.md + gallery_data.csv + gallery_data_zh.csv after
   website render.

6. Update generate-skills.yml: Add unified skill.md regeneration and
   commit alongside per-tutorial skills. Reference skill-spec.md.

7. Update generate_skills.py: Add generate_unified_skill() function that
   builds skill.md from skills/index.json. Update spec file references
   from skill.md to skill-spec.md.

Agent-Logs-Url: https://github.com/openbiox/Bizard/sessions/d7b279b9-6241-402c-8062-1b941a90d6fe

Co-authored-by: ShixiangWang <25057508+ShixiangWang@users.noreply.github.com>
Copilot AI changed the title [WIP] Redesign and implement Skill functionality Redesign Skill system: unified skill package with ZIP download Apr 16, 2026
Copilot AI requested a review from ShixiangWang April 16, 2026 03:11
@ShixiangWang
Copy link
Copy Markdown
Member

ShixiangWang commented Apr 16, 2026

实现的有一些问题,我希望的是用户在网站能点击下载bizard的skill压缩包,压缩包里包含 skill.md(包括对gallery_data.csv的指向和利用) 和 gallery_data.csv,(加一个 README.md,可选),这样用户可以直接将该skill安装到任意ai工具里使用。当前skill.md更像一个README.md,而不是利用Bizard的skill。

请认真思考我的需求进行修改优化

@copilot

skill.md is now a proper AI skill that instructs AI assistants how to
use Bizard's gallery_data.csv to recommend visualizations and generate
code. It includes: role definition, gallery CSV column reference,
workflow for answering queries, decision guide, code conventions, and
response format.

Added files/bizard-skill-readme.md with installation instructions for
ChatGPT, Claude, Copilot, and local LLMs.

Updated quarto-publish.yml to include README.md in the ZIP package.
Updated generate_unified_skill() to produce the new AI skill format.
Updated Skills.qmd/zh.qmd descriptions to explain the skill's purpose.

Agent-Logs-Url: https://github.com/openbiox/Bizard/sessions/78fe388d-1ba4-4eaa-9a15-a69176258161

Co-authored-by: ShixiangWang <25057508+ShixiangWang@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Apr 16, 2026

实现的有一些问题,我希望的是用户在网站能点击下载bizard的skill压缩包,压缩包里包含 skill.md(包括对gallery_data.csv的指向和利用) 和 gallery_data.csv,��...

Redesigned in a39e426. Key changes:

skill.md is now a proper AI skill instruction document — it defines the AI's role as a biomedical visualization expert, teaches it how to search gallery_data.csv (by Type/Level1/Level2/keyword), provides a decision guide mapping research goals → visualization types, includes code conventions (R/Python/Julia with package guards), and specifies a structured response format.

ZIP contents (bizard-skill.zip):

  • skill.md — AI skill instructions (the AI's "system prompt")
  • gallery_data.csv — 793 figure examples with image URLs, tutorial links, descriptions
  • gallery_data_zh.csv — Chinese version
  • README.md — Installation guide for ChatGPT, Claude, Copilot Chat, local LLMs

The generate_unified_skill() function auto-regenerates skill.md from skills/index.json whenever tutorials are updated, keeping counts and categories in sync.

@ShixiangWang ShixiangWang marked this pull request as ready for review April 16, 2026 04:21
@ShixiangWang ShixiangWang merged commit e969784 into main Apr 16, 2026
@ShixiangWang ShixiangWang deleted the copilot/redesign-and-implement-skill branch April 16, 2026 04:21
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.

Skill重设计和实施

2 participants