qwen-gsd

Get Shit Done for Qwen Code — A spec-driven workflow system with 20+ specialized skills for production-ready development.

What It Is

qwen-gsd is a skills and workflow system for Qwen Code that extends the AI's capabilities with specialized knowledge for database design, API development, debugging, Docker, security audits, and more. Modelled on the popular "get-shit-done" system for Claude Code.

Unlike generic AI assistants, qwen-gsd provides structured, repeatable workflows with spec-driven development patterns. Plan → Build → Review → Ship with clear acceptance criteria at each stage.

Quick Install

# Install globally (all projects)
npx qwen-gsd --global

# Or install for current project only
npx qwen-gsd --local

After installation, Qwen Code will automatically load skills when you mention them.

Core Commands

| Command | Description | |---------|-------------| | /qwen:new-project | Initialize a new project with requirements and roadmap | | /qwen:plan [N] | Plan phase N in detail — tasks, acceptance criteria, risks | | /qwen:build | Execute the current phase plan with verification checkpoints | | /qwen:review | Verify completed work against acceptance criteria | | /qwen:debug | Systematic root cause debugging for errors | | /qwen:progress | View and update project state | | /qwen:ship | Prepare release — tests, changelog, version bump | | /qwen:help | List all available commands |

Skills Catalog

Core Skills

| Skill | What It Does | Trigger Phrase | |-------|--------------|----------------| | debug | Root cause debugging with systematic tracing | "debug this error" | | code-review | Code review with best practices checklist | "review this code" | | test-writer | Write comprehensive tests | "write tests for this" | | changelog-generator | Generate changelog from git history | "generate changelog" | | skill-creator | Create new custom skills | "create a skill for X" |

Document Skills

| Skill | What It Does | Trigger Phrase | |-------|--------------|----------------| | docx | Generate and edit Word documents | "create a docx" | | pdf | Read and process PDF files | "read this pdf" |

Development Skills

| Skill | What It Does | Trigger Phrase | |-------|--------------|----------------| | database-schema | Design PostgreSQL/MySQL schemas and migrations | "design the database" | | api-design | REST API design with OpenAPI spec | "design the API" | | refactor | Safe code refactoring with behavior preservation | "refactor this code" | | git-workflow | Branch strategy, commit messages, PR templates | "set up git workflow" | | docker | Dockerfile and docker-compose for common stacks | "dockerize this" | | readme-generator | Professional README with badges and docs | "create a README" | | sql-query-builder | Safe parameterized SQL queries | "write a SQL query" | | env-config | Environment variables and config management | "set up environment" |

Framework Skills

| Skill | What It Does | Trigger Phrase | |-------|--------------|----------------| | fastapi-patterns | FastAPI project structure and patterns | "build a FastAPI app" | | nextjs-patterns | Next.js App Router and server components | "build a Next.js app" |

Analysis Skills

| Skill | What It Does | Trigger Phrase | |-------|--------------|----------------| | data-analysis | Analyze CSV/JSON with pandas | "analyze this data" | | security-audit | Scan for OWASP Top 10 vulnerabilities | "security audit" | | performance-profile | Identify bottlenecks and optimize | "profile performance" |

How It Works

Qwen Code reads markdown files from a config directory:

• Global config: ~/.config/qwen-code/
• Local config: .qwen-code/ (project root)

Three types of files:

1. skills/[name]/SKILL.md — Loaded when you say "use the X skill" or Qwen detects the task matches
2. commands/qwen/[name].md — Slash commands like /qwen:new-project
3. agents/[name].md — Subagent definitions called via Task tool

SKILL.md Format

---
name: skill-name
description: When to use this skill. One sentence, specific.
---
# Skill Name

[Instructions for Qwen Code in imperative form]

## When to Use
- Situation 1
- Situation 2

## How to Use
[Step-by-step workflow with code examples]

Example Usage

User: "Use the database-schema skill to design a schema for a blog"

Qwen Code: [Loads the database-schema skill and follows its instructions]

Creating Custom Skills

Use the built-in skill-creator to make custom skills:

/qwen:help skill-creator

Or manually:

1. Create a directory: my-skill/
2. Add SKILL.md with frontmatter and instructions
3. Copy to ~/.config/qwen-code/skills/my-skill/

See the skill-creator skill for detailed guidance.

Project Structure

qwen-gsd/
├── bin/
│   └── install.js        # Installation script
├── commands/qwen/        # Slash commands
│   ├── new-project.md
│   ├── plan.md
│   ├── build.md
│   ├── review.md
│   ├── debug.md
│   ├── progress.md
│   ├── ship.md
│   └── help.md
├── skills/               # Specialized skills (20 total)
│   ├── debug/
│   ├── database-schema/
│   ├── api-design/
│   └── ...
├── agents/               # Subagent definitions
│   ├── qwen-planner.md
│   ├── qwen-verifier.md
│   ├── qwen-debugger.md
│   └── qwen-researcher.md
├── workflows/            # Detailed workflow instructions
│   ├── new-project.md
│   ├── plan-phase.md
│   ├── build.md
│   ├── review.md
│   ├── debug.md
│   └── ship.md
├── templates/            # Templates for planning docs
│   ├── project.md
│   ├── state.md
│   ├── phase.md
│   ├── requirements.md
│   └── roadmap.md
└── references/           # Reference documentation
    ├── questioning.md
    ├── verification-patterns.md
    ├── phase-format.md
    └── tdd.md

Contributing

Contributions are welcome! Here's how to contribute:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-skill
3. Add your skill in skills/amazing-skill/SKILL.md
4. Test with npx qwen-gsd --local
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines on creating skills.

Good Skill Ideas

• Integration with specific services (Stripe, Twilio, SendGrid)
• Domain-specific knowledge (healthcare, finance, e-commerce)
• Tool integrations (Terraform, Kubernetes, AWS CDK)
• Testing frameworks (Playwright, Cypress, Jest patterns)
• Code generation (GraphQL schemas, protobuf, OpenAPI)

License

MIT License — see LICENSE for details.

Made with ❤️ by Cosmiq AI