🚀 GeneralUpdate Agent Skills Suite

Claude Code Skill Suite — Helps .NET developers integrate the GeneralUpdate auto-update system into any .NET application in 5 minutes.

Covers 50+ real-world issues discovered through GitHub/Gitee, providing production-ready code generation + deep troubleshooting.

Current Version: 0.0.2-beta.1 — targets NuGet GeneralUpdate.Core 10.5.0-beta.7
Compatibility: v10.5.0-beta.7 (latest NuGet preview release)
All templates have passed dotnet build verification (0 errors).

📖 What is an Agent Skill?

An Agent Skill is a reusable instruction template that gives AI coding assistants domain-specific knowledge and standardized workflows.

In one sentence: Skill = domain expert knowledge + standardized workflow, injected into the AI assistant so it can handle that domain like an experienced developer.

What problem does Skill solve?

Without a Skill, asking an AI assistant to help with GeneralUpdate integration requires:

Explaining the dual-process architecture, API, strategies in detail — every single time
Repeating this background knowledge in each conversation
Risk of missing edge cases, security considerations in generated code

With a Skill:

A single command (e.g., /generalupdate-init) triggers the complete workflow
AI automatically loads domain knowledge (architecture, API, known issues, best practices)
Output is standardized, production-verified code

This suite contains 7 Skills

Skill	One-line description
`generalupdate-init`	Scaffold dual projects + Bootstrap config from scratch
`generalupdate-ui`	Auto-detect UI framework, generate full-state update window
`generalupdate-strategy`	Choose the optimal update strategy (OSS/Silent/Diff/etc.)
`generalupdate-advanced`	Bowl crash daemon, IPC, Pipeline, custom Hooks
`generalupdate-troubleshoot`	Diagnose 50+ known issues, match fix solutions
`generalupdate-migration`	v9.x → v10 / dev-branch → stable migration
`generalupdate-security-audit`	14 security checks + remediation recommendations

📦 Installing Skills

Get the Skill Files

All Skill files are hosted in a dedicated repository:

https://github.com/GeneralLibrary/generalupdate-skill-codegen

Repository structure:

generalupdate-skill-codegen/
├── SKILL.md                          ← Suite entry point
└── .claude/skills/
    ├── generalupdate-init/           ← 🚀 Integration Guide
    ├── generalupdate-ui/             ← 🎨 UI Generation
    ├── generalupdate-strategy/       ← ⚙️ Strategy Guide
    ├── generalupdate-advanced/       ← 🔧 Advanced Customization
    ├── generalupdate-troubleshoot/   ← 🩺 Troubleshooting
    ├── generalupdate-migration/      ← 🔄 Migration Guide
    └── generalupdate-security-audit/ ← 🔒 Security Audit

Option 1: Clone directly into your project

# Run in your project root
git clone https://github.com/GeneralLibrary/generalupdate-skill-codegen.git
cp -r generalupdate-skill-codegen/.claude/skills .claude/
cp generalupdate-skill-codegen/SKILL.md .claude/
rm -rf generalupdate-skill-codegen

Option 2: Git submodule (recommended for teams)

# Run in your project root
git submodule add https://github.com/GeneralLibrary/generalupdate-skill-codegen.git .claude/generalupdate-skill-codegen
ln -s .claude/generalupdate-skill-codegen/.claude/skills .claude/skills 2>/dev/null || \
  cp -r .claude/generalupdate-skill-codegen/.claude/skills .claude/

Benefit of submodule: git submodule update --remote pulls the latest Skill updates.

Option 3: Copy only what you need

# Copy only the skill you need
git clone https://github.com/GeneralLibrary/generalupdate-skill-codegen.git /tmp/gussc
cp -r /tmp/gussc/.claude/skills/generalupdate-init .claude/skills/
rm -rf /tmp/gussc

🤖 Integration with Various AI Coding Assistants

This suite supports the following AI coding assistants. Choose the integration method based on your tool:

Claude Code (Desktop / CLI)

Desktop:

Place the .claude/skills/ directory in your project root (see installation steps above)
Restart Claude Code desktop
Type /generalupdate-init to use

CLI:

Place the .claude/skills/ directory in your project root
Restart Claude Code CLI
Type /generalupdate-init to test

Verification: Type /generalupdate-init — if you see the integration guide output, installation was successful.

GitHub Copilot (VS Code)

Install via .github/copilot-instructions.md (or project instructions):

Extract the core instructions from generalupdate-skill-codegen/SKILL.md
Place them in .github/copilot-instructions.md in your project root
Or add the skill repository as a Copilot knowledge base in GitHub repository settings

Note: GitHub Copilot uses instructions rather than slash commands, so Skill content needs to be reformatted as instructions.

Cursor

Cursor supports .cursorrules files, similar to Claude Code skills:

Create or edit .cursorrules in your project root
Append the core instructions from the needed Skill (e.g., generalupdate-init/SKILL.md)
Or use Cursor's Docs feature to add the skill-codegen repo as a reference document

Windsurf

Create a .windsurfrules file in your project root
Embed the needed Skill knowledge into this file
Reference: describe your requirements in conversation, the AI responds based on rules file knowledge

Cline / Continue.dev (VS Code Extensions)

Reference Skill knowledge in .clinerules or .continuerc
Or directly add Skill content to the project's AI rules file

DeepSeek / Tongyi Lingma / Other Chinese AI Assistants

Place an AI_INSTRUCTIONS.md or CODEGEN.md file in your project root
Write key Skill instructions in natural language into this file
Reference this file as context when starting a conversation

✅ Verify Installation

Regardless of which AI assistant you use, the verification is the same:

Ask the AI: "Add auto-update to my .NET application"

If the AI outputs a GeneralUpdate dual-project structure + Bootstrap config code → Success
If the AI only gives generic suggestions → Needs more Skill context

Prerequisites

AI Coding Assistant: A tool that supports custom instructions/rules
.NET SDK: Target project must be .NET 8+ (.NET 10 recommended)
GeneralUpdate Server: For standard strategies, deploy GeneralSpacestation or a compatible backend service
Dual-Process Architecture: Understand the Client + Upgrade dual-process concept

🧭 Developer Integration Roadmap

Which situation are you in? Find your entry point and follow the steps:

Your Scenario	Start Here	What to Do	Next Step After
🆕 First time, starting from scratch	`/generalupdate-init`	① Pick integration mode → ② Generate Bootstrap → ③ Deploy	`/generalupdate-ui` (add UI)
🎨 Already integrated, need UI	`/generalupdate-ui`	① Auto-detect framework → ② Generate window → ③ Bridge events	`/generalupdate-strategy` (pick strategy)
⚙️ Need a strategy (OSS/Silent/Diff)	`/generalupdate-strategy`	① Decision tree → ② Configure server → ③ Example code	`/generalupdate-init` (config Bootstrap)
🔧 Need advanced (Bowl/IPC/Hooks)	`/generalupdate-advanced`	① Pick extension → ② Generate template code → ③ Integrate	Deploy & verify
🩺 Update failing/errors/exceptions	`/generalupdate-troubleshoot`	① Collect symptoms → ② Match known issues → ③ Fix	Return to relevant skill
🔄 Have v9.x, need to migrate to v10	`/generalupdate-migration`	Follow migration paths + API comparison table	`/generalupdate-troubleshoot` (check issues)
🔒 Need security audit	`/generalupdate-security-audit`	14 security checks + audit report	`/generalupdate-init` (fix findings)

Skills Overview

Skill	Command	Description	Coverage
🚀 generalupdate-init	`/generalupdate-init`	Dual-project scaffold + Bootstrap config (4 methods)	4 update scenes + 4 config modes + full API
🎨 generalupdate-ui	`/generalupdate-ui`	Auto-detect UI framework, generate full-state update window (11 states)	6 UI frameworks + full state machine + bridge code
⚙️ generalupdate-strategy	`/generalupdate-strategy`	6 strategy decision tree + mixed combinations + platform differences	6 strategies + 4 combinations + platform reference
🔧 generalupdate-advanced	`/generalupdate-advanced`	10+ extension points + 4 IPC + Bowl + AOT	10+ extension points + architecture guide
🩺 generalupdate-troubleshoot	`/generalupdate-troubleshoot`	50+ known issue diagnosis + BM25 search engine	8 Critical + 11 High + 20 Medium + 12 Low
🔄 generalupdate-migration	`/generalupdate-migration`	v9.x → v10 / dev-branch → stable migration	2 migration paths + API comparison table
🔒 generalupdate-security-audit	`/generalupdate-security-audit`	Security audit + remediation	14 security matrix + audit report template

Quick Start

In your AI coding assistant, just describe your needs and the corresponding Skill will auto-activate:

"Add auto-update to my WPF application"
→ Auto-activates generalupdate-init + generalupdate-ui

"Update succeeded but app crashes on startup"
→ Auto-activates generalupdate-troubleshoot

"Configure OSS silent update"
→ Auto-activates generalupdate-strategy

"Add Bowl crash daemon + custom Hooks"
→ Auto-activates generalupdate-advanced

"Migrate my v9.x project to v10"
→ Auto-activates generalupdate-migration

Generic Integration Verification Checklist

Regardless of which skill you use, check these items after integration:

Bootstrap Configuration

All 6 required UpdateRequest fields are set (UpdateUrl, AppSecretKey, MainAppName, ClientVersion, ProductId, InstallPath)
UpdateUrl points to a server API that returns valid version info
AppSecretKey length ≥ 16 characters, consistent with server
InstallPath points to the correct install directory (production: AppDomain.CurrentDomain.BaseDirectory)
AppType is set correctly (Client = 1, Upgrade = 2)

NuGet & Build

Client and Upgrade projects use the exact same GeneralUpdate NuGet version
Project builds with dotnet build (0 errors)

Deployment Structure

UpgradeApp.exe exists in the publish directory (required from first release)
generalupdate.manifest.json has UpdateAppName including .exe
IPC file (UpdateInfo.msg) path is consistent between Client/Upgrade
Encoding is set to Encoding.UTF8 (prevents garbled text on Linux/macOS)

Data Sources

All skill content is based on real-world data:

GitHub Issues: #308–#517 (refactoring, bugs, features, tests)
Gitee Issues: 30 real user feedback (Chinese community pain points)
Full Code Audit: 17 CRITICAL/HIGH + 14 MEDIUM + 10 INFO findings
Samples Source Code: CompleteUpdateSample, SilentUpdateSample, OssSample, DifferentialSample, PushSample, BowlSample, ExtensionSample, CompressSample, ImDiskQuickInstallSample
UI Samples: SemiUrsa, LayUI, AntdUI, WPFDevelopers, MauiUpdate, AndroidUpdate

Skill File Structure

.claude/skills/
├── generalupdate-init/         (7 files)
│   ├── SKILL.md
│   ├── reference.md
│   └── templates/
│       ├── MinimalIntegration.cs
│       ├── FullIntegration.cs
│       ├── generalupdate.manifest.json
│       └── project-scaffold/
│
├── generalupdate-ui/           (10 files)
│   ├── SKILL.md
│   └── templates/
│       ├── RealDownloadService.cs
│       ├── DownloadViewModels.cs
│       ├── SemiUrsaClientView.axaml / SemiUrsaUpgradeView.axaml
│       ├── LayUIStyle.xaml / WPFDevelopersStyle.xaml
│       ├── AntdUIStyle.cs
│       └── MauiUpdatePage.xaml/.cs
│
├── generalupdate-strategy/     (7 files)
│   ├── SKILL.md
│   └── examples/
│       ├── ClientServerStrategy.cs / OssStrategy.cs
│       ├── SilentStrategy.cs / DifferentialStrategy.cs
│       └── CrossVersionStrategy.cs / PushStrategy.cs
│
├── generalupdate-advanced/     (6 files)
│   ├── SKILL.md
│   ├── reference.md
│   └── templates/
│       ├── CustomHooks.cs / CustomStrategy.cs
│       ├── BowlIntegration.cs / NamedPipeIPC.cs
│
├── generalupdate-troubleshoot/ (5+ files)
│   ├── SKILL.md
│   ├── reference.md            ← 50+ symptom checklist (C/H/M/L levels)
│   ├── scripts/search.py       ← BM25 search engine
│   ├── scripts/core.py         ← BM25 algorithm core
│   └── data/issues.csv         ← 51 known issues database
│
├── generalupdate-migration/    (1 file)
│   └── SKILL.md                ← v9.x→v10 / dev-branch→stable migration
│
└── generalupdate-security-audit/ (1 file)
    └── SKILL.md                ← 14 security audit matrix

API Compatibility Notes

⚠️ NuGet Reference Rules (v10.5.0-beta.7):

Core only: dotnet add package GeneralUpdate.Core --version 10.5.0-beta.7

With Bowl: reference both GeneralUpdate.Core and GeneralUpdate.Bowl (no type conflicts in v10.5.0-beta.7)

Differential is embedded in Core, no need for a separate GeneralUpdate.Differential reference

⚠️ API Surface: v10.5.0-beta.7 adopts a completely new configuration system:

✅ UpdateRequest / UpdateRequestBuilder — replaces old Configinfo

✅ SetSource(updateUrl, appSecretKey) — zero-config entry point

✅ SetOption<T>(Option<T>, T) — programmable configuration system

✅ IUpdateHooks — lifecycle hooks (Hooks<T>())

✅ IStrategy — replaceable strategy interface (Strategy<T>())

✅ UseDiffPipeline(Action<DiffPipelineBuilder>) — differential pipeline config

✅ SilentPollOrchestrator — silent polling

✅ AddListenerProgress — 7th event listener

❌ Configinfo class has been removed

Feedback & Suggestions

If you encounter any issues or have suggestions for improvement, please submit an Issue:

GitHub Issues: GeneralUpdate-Samples/issues — Report bugs, request features
Skill Repository: generalupdate-skill-codegen/issues — Skill content issues and suggestions
GeneralUpdate Issues: GeneralUpdate/issues — Core library bugs and feature requests

For faster resolution, please include:

GeneralUpdate version (e.g. v10.5.0-beta.7)
Platform (Windows / Linux / macOS)
Update strategy (Standard / OSS / Silent / Differential / Push)
Full error log (available from Logs/generalupdate-trace-*.log)

Version History

0.0.2-beta.1 — 2026-06-16

Updated for GeneralUpdate v10.5.0-beta.7 API:

Configinfo → UpdateRequest (namespace: GeneralUpdate.Core.Configuration)
Event args moved to GeneralUpdate.Core.Download and GeneralUpdate.Core.Event
Added SetSource(), SetOption(), Hooks<T>(), Strategy<T>() API coverage
Updated all strategy examples to use the new API
Updated CustomHooks.cs and CustomStrategy.cs to show v10.5 capabilities
Fixed IsComplated → IsCompleted
NuGet version bumped to 10.5.0-beta.7
Added 2 new skills: generalupdate-migration, generalupdate-security-audit

0.0.1-beta.1 — 2026-06-16

Initial beta release. All templates rewritten for NuGet v10.4.6 stable API.

GeneralUpdate — .NET auto-update core library
GeneralSpacestation — Update server
generalupdate-skill-codegen — Agent Skills suite repository
GeneralUpdate-Samples — Sample projects

🚀 GeneralUpdate Agent Skills Suite

📖 What is an Agent Skill?​

What problem does Skill solve?​

This suite contains 7 Skills​

📦 Installing Skills​

Get the Skill Files​

Option 1: Clone directly into your project​

Option 2: Git submodule (recommended for teams)​

Option 3: Copy only what you need​

🤖 Integration with Various AI Coding Assistants​

Claude Code (Desktop / CLI)​

GitHub Copilot (VS Code)​

Cursor​

Windsurf​

Cline / Continue.dev (VS Code Extensions)​

DeepSeek / Tongyi Lingma / Other Chinese AI Assistants​

✅ Verify Installation​

Prerequisites​

🧭 Developer Integration Roadmap​

Skills Overview​

Quick Start​

Generic Integration Verification Checklist​

Bootstrap Configuration​

NuGet & Build​

Deployment Structure​

Data Sources​

Skill File Structure​

API Compatibility Notes​

Feedback & Suggestions​

Version History​

0.0.2-beta.1 — 2026-06-16​

0.0.1-beta.1 — 2026-06-16​

Related Projects​