Are there any prerequisites for running this migration?

You must run the skill from the repository root and be authenticated with GitHub via 'gh auth status' for the target repository.

What is an artifact-first GitHub Issue?

It is a workflow where project specifications (specs, plans, tasks) are managed as discrete, versioned artifacts within a GitHub Issue rather than plain text in the issue body.

Does this skill delete my local files?

Yes, after a successful migration, the skill removes the old local specification directories to prevent duplicate sources of truth and keep your repository clean.

Can I preview the migration before it happens?

Yes, the skill includes a dry-run command that allows you to review planned migration counts and deletion targets before any changes are finalized.

What documentation files are supported for migration?

The migration script handles spec.md, plan.md, tasks.md, research.md, data-model.md, and quickstart.md, as well as artifacts in contracts and checklists folders.

GWT Spec to Issue Migrator

Name: GWT Spec to Issue Migrator
Author: akiojin

byakiojin

•

协作工具

Migrates legacy local specification files and body-canonical GitHub Issues to a modern artifact-first GitHub Issue workflow.

This skill facilitates the transition from file-based specification management to an Issue-first approach using GitHub Issues. It automates the detection of local specs/SPEC-* directories, converts documentation like spec.md, plan.md, and tasks.md into GitHub Issue artifacts, and handles the cleanup of deprecated local files. It is ideal for teams looking to centralize their development requirements and project artifacts directly within GitHub's ecosystem while maintaining a clean repository state and a single source of truth.

主要功能

01Automated cleanup of retired source files and migration reports

02Automatic detection of legacy local specification directories

03Converts local Markdown specs into GitHub Issue comments and artifacts

043 GitHub stars

05Supports updating existing body-canonical Issues to artifact-first formats

06Dry-run mode to preview migration plans and planned file deletions

使用场景

01Modernizing a repository that uses local spec directories to use GitHub-native issue tracking

02Updating existing GitHub issue-based specs from legacy formats to structured artifact formats

03Consolidating project documentation and task lists into GitHub for improved team collaboration

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add akiojin/gwt gwt-spec-to-issue-migration

For use in Claude.ai and ChatGPT

主要功能

01Automated cleanup of retired source files and migration reports

02Automatic detection of legacy local specification directories

03Converts local Markdown specs into GitHub Issue comments and artifacts

043 GitHub stars

05Supports updating existing body-canonical Issues to artifact-first formats

06Dry-run mode to preview migration plans and planned file deletions

使用场景

01Modernizing a repository that uses local spec directories to use GitHub-native issue tracking

02Updating existing GitHub issue-based specs from legacy formats to structured artifact formats

03Consolidating project documentation and task lists into GitHub for improved team collaboration

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add akiojin/gwt gwt-spec-to-issue-migration

For use in Claude.ai and ChatGPT