Set Up the AI Workflow Framework Skills

Seven skills and an agent implementing the AI Workflow Framework — from analyzing where AI fits in your workflows through building, testing, running, and improving working AI workflows. Find your platform below and follow the setup instructions.

Set Up These Skills

Find your platform below and click to expand the setup instructions. Each section has everything you need — no jumping between pages.

Skill Support by Platform

For a full comparison of platforms — skill support status, directory locations, execution environments, and filesystem access — see Platform Implementations and Where Skills Run on the Skills building block page.

---

Chat & Desktop Platforms

Use AI through a browser or desktop app? Find your platform and click to expand.

Claude Chat (claude.ai) — ✅ Native skill support

Claude.ai officially supports Agent Skills. You upload a skill file and Claude uses it automatically in your conversations.

Official docs: Use Skills in Claude

What you need first: A Claude Pro, Max, Team, or Enterprise subscription.

Step 1 — Turn on code execution

1. Go to claude.ai in your web browser
2. Look at the bottom-left corner of the screen and click the gear icon (⚙️) to open Settings
3. In Settings, click Capabilities in the left menu
4. Find the toggle next to Code execution and make sure it’s turned on (it should appear blue/active)

This setting lets Claude run skills — it does not give Claude access to your computer.

Step 2 — Download a skill

1. Open the skill downloads page in your web browser
2. Scroll down to the Assets section — you’ll see a list of .zip files, one for each skill
3. Click analyze.zip to download it (start with Analyze — it’s Step 1 of the framework)

The file downloads to your computer (usually to your Downloads folder). You can download multiple skills at once if you like.

Step 3 — Upload the skill to Claude

1. Go back to claude.ai in your browser
2. In the left sidebar, click Customize
3. Click Skills
4. Click the + button, then choose Create skill
5. Click Upload skill and select the analyze.zip file you just downloaded

Step 4 — Turn the skill on

After uploading, find “analyze” in your Skills list and make sure the toggle next to it is on (blue/active).

Step 5 — Test it

Start a new chat on claude.ai and type:

Help me analyze AI workflow opportunities

Claude should begin a structured interview process — asking about your role, your workflows, and where AI might help.

Step 6 — Add more skills as you need them

Go back to the skill downloads page and download the next skill you need. Repeat Steps 3–4 for each one.

Framework Step	Skill	Direct download
1	Analyze	analyze.zip
2	Deconstruct	deconstruct.zip
3	Design	design.zip
4	Build	build.zip
5	Test	test.zip
6	Run	run.zip
7	Improve	improve.zip

Start with Analyze and Deconstruct — add the rest as you progress through the framework.

To refresh a skill later, see Update the Skills → Claude Chat — re-uploading replaces the existing version.

Claude Cowork (Desktop App) — ✅ Native skill support

Cowork has a built-in plugin directory — no files to download or copy. This is the simplest setup path.

Official docs: Use Plugins in Cowork

Personal plugins blocked at your company?

Some organizations disable personal plugins in Cowork. If you don’t see the Personal tab in Browse plugins, or your admin has restricted plugin installs, use the Claude Chat (claude.ai) instructions in the section above instead — download the skill .zip files from GitHub Releases and upload them via Customize → Skills → + → Create skill → Upload skill. Skills uploaded this way are shared across Claude Chat and Cowork on the same account, so they’ll show up in Cowork automatically.

What you need first: The Claude Desktop app installed, with a Claude Pro, Max, Team, or Enterprise subscription.

Step 1 — Turn on code execution

Skills require code execution to be enabled. If you haven’t already:

1. In the Claude Desktop app, click the gear icon (⚙️) in the bottom-left to open Settings
2. Click Capabilities
3. Make sure the toggle next to Code execution and file creation is turned on (blue)

This lets Claude run skills — it does not give Claude access to your computer. See Use Skills in Claude for details.

Step 2 — Open Cowork

1. Open the Claude Desktop app
2. At the top center of the window, you’ll see three tabs: Chat, Cowork, and Code. Click Cowork.

Step 3 — Go to Customize

1. In the left sidebar, click Customize (near the bottom of the sidebar)
2. Click Browse plugins — this opens the plugin directory

Step 4 — Add the marketplace (one-time setup)

If this is your first time, you need to add the Hands-on AI marketplace:

1. In the plugin directory, click the Personal tab at the top
2. Click the + button (next to the marketplace name area)
3. Click Add marketplace
4. In the “Add marketplace” dialog, type jamesgray-ai/handsonai-plugins in the URL field
5. A dropdown may appear showing “Couldn’t load the repository list. Type owner/repo below to continue.” — this warning is harmless. Click the “Use ‘jamesgray-ai/handsonai-plugins’” option that appears below it.
6. Click Sync

You only need to do this once — the marketplace is remembered.

Step 5 — Install the Hands-on AI plugin

1. After syncing, you should see handsonai as a plugin card in the Personal tab
2. Click the + button on the handsonai card to install it

Need to refresh the skills later?

See Update the Skills for the two-step Cowork refresh flow.

Step 6 — Start using it

Skills are available immediately — no restart needed. Go back to Cowork and describe what you need in plain language. For example, type:

Help me analyze where AI fits in my work

Cowork automatically activates the right skill based on your request.

Claude Code (Desktop App) — ✅ Native skill support

The Claude Desktop app includes a Code tab that supports plugins and skills.

Official docs: Extend Claude with Skills · Discover and Install Plugins

Personal plugins blocked at your company?

Some organizations disable personal plugins. If you can’t add a marketplace or install plugins in the Code tab, use the Claude Chat (claude.ai) instructions above to upload skill .zip files via Customize → Skills → + → Create skill → Upload skill — that path makes the skills available in Claude Chat and Cowork on the same account, which covers most of the framework workflow. (Slash commands like /handsonai:analyze are specific to the Code tab and require the plugin install.)

What you need first: The Claude Desktop app installed, with a Claude Max subscription (the Code tab requires Max).

Step 1 — Open the Code tab

1. Open the Claude Desktop app
2. At the top center of the window, you’ll see three tabs: Chat, Cowork, and Code. Click Code.

Step 2 — Add the marketplace (one-time setup)

1. In the left sidebar, click Customize
2. Click Browse plugins
3. Click the Personal tab at the top
4. Click the + button, then click Add marketplace
5. In the “Add marketplace” dialog, type jamesgray-ai/handsonai-plugins in the URL field
6. A dropdown may appear showing “Couldn’t load the repository list. Type owner/repo below to continue.” — this warning is harmless. Click the “Use ‘jamesgray-ai/handsonai-plugins’” option that appears below it.
7. Click Sync

You only need to do this once.

Step 3 — Install the plugin

1. After syncing, you should see handsonai as a plugin card in the Personal tab
2. Click the + button on the handsonai card to install it

Step 4 — Test it

Go back to the Code tab and type:

/handsonai:analyze

Press Enter. The Analyze skill should start running and begin asking you questions. You can also just type “Help me analyze AI workflow opportunities” and Claude will activate the right skill automatically.

Alternative: install using slash commands

You can also install directly from the Code tab’s input area using slash commands. Type the first command and press Enter:

/plugin marketplace add jamesgray-ai/handsonai-plugins

Then type this command and press Enter:

/plugin install handsonai@handsonai

This achieves the same result as the visual method above.

For updates, uninstalling, and troubleshooting, see Using Plugins.

ChatGPT — 🟡 Beta / Limited native support

There are three ways to use these skills with your ChatGPT account, listed from best to simplest:

Option 1: Native Skills (Best — if your plan supports it)

ChatGPT is rolling out native skill support using the same SKILL.md format. Skills work directly in ChatGPT and output files can be downloaded from the chat. This is the best option if available on your plan (currently Enterprise, Edu, and some Team/Business plans — admins may need to enable it).

If you don’t see a Skills option in your ChatGPT settings, try Option 2 or 3 below.

Step 1 — Download the skills

1. Open the skill downloads page in your web browser
2. Scroll down to the Assets section — you’ll see a list of .zip files, one for each skill
3. Click each skill .zip to download it. Start with analyze.zip and deconstruct.zip — add the rest as you progress through the framework.

The files download to your computer (usually to your Downloads folder).

Framework Step	Skill	Direct download
1	Analyze	analyze.zip
2	Deconstruct	deconstruct.zip
3	Design	design.zip
4	Build	build.zip
5	Test	test.zip
6	Run	run.zip
7	Improve	improve.zip

Step 2 — Upload the skills to ChatGPT

Follow OpenAI’s official guide to upload the .zip files you just downloaded: Skills in ChatGPT. The guide walks through enabling Skills in your workspace and uploading skill .zip files from your computer.

Step 3 — Test it

Start a new ChatGPT conversation and type:

Help me analyze AI workflow opportunities

ChatGPT should activate the Analyze skill and begin a structured interview process.

Option 2: OpenAI Codex in a Code Editor

Use OpenAI Codex in a code editor like Cursor or VS Code. Codex uses your existing ChatGPT login (Plus, Pro, or any paid plan), supports skills natively, and saves output files directly to your computer — so when a skill creates a Workflow Requirements or Design Spec, you get an actual file instead of text in a chat window.

See the OpenAI Codex section under Code Editors & Terminal below for setup instructions.

Option 3: ChatGPT Projects (Simplest — works on all paid plans)

Official docs: Projects in ChatGPT

What you need first: A ChatGPT Plus, Team, or Enterprise subscription.

A Project in ChatGPT is like a folder where ChatGPT remembers specific instructions for all conversations inside it. You’ll create one Project per skill, and paste the skill’s instructions into it.

Step 1 — Copy the skill instructions

1. Scroll down to the Skill Files table on this page
2. Click the SKILL.md link for Analyze (the first skill in the framework) — this opens a page on GitHub showing the skill’s text

Step 2 — View the raw text

1. On the GitHub page, look near the top-right of the file content area
2. Click the button that says Raw — this shows you the plain text without any GitHub formatting

Step 3 — Select and copy all the text

1. Click anywhere on the page, then:
   • Mac: Press Cmd+A (this selects all the text), then press Cmd+C (this copies it)
   • Windows: Press Ctrl+A (selects all), then press Ctrl+C (copies it)

Step 4 — Create a new Project in ChatGPT

1. Go to chatgpt.com in your web browser
2. In the left sidebar, look for Projects and click it
3. Click New Project

Step 5 — Name the Project

Give it a clear name that matches the skill, like “Analyze Workflows” or “Step 1 — Analyze”.

Step 6 — Add the instructions

1. Click Instructions (or “Custom Instructions”) — a text box appears
2. Click inside the text box
3. Paste the text you copied:
   • Mac: Press Cmd+V
   • Windows: Press Ctrl+V

Step 7 — Save

Click Save or Done.

Step 8 — Use the skill

1. Open your new “Analyze Workflows” Project from the sidebar
2. Start a conversation by typing:

Help me analyze where AI fits in my work

ChatGPT will follow the skill’s structured interview process — asking about your role, workflows, and where AI might help.

Step 9 — Add more skills later

Repeat steps 1–7 for Deconstruct (the next step in the framework). Add the remaining skills as you progress.

About file saving with Projects

When a skill says it will “save output to a file,” ChatGPT Projects will show the output in the chat instead — copy and save it yourself. For automatic file saving, use Option 1 (Native Skills) or Option 2 (OpenAI Codex) above.

Google Gemini (app) — 🟠 Workaround using Gems

The Gemini app does not natively support Agent Skills yet. These instructions use Gems — Gemini’s custom AI personas — to achieve the same result. You paste the skill’s instructions into a Gem, and Gemini follows them.

Official docs: Use Gems in Gemini Apps

What you need first: A Gemini Advanced subscription (required for the Gems feature).

Step 1 — Copy the skill instructions

1. Scroll down to the Skill Files table on this page
2. Click the SKILL.md link for Analyze (the first skill) — this opens a page on GitHub

Step 2 — View the raw text

1. On the GitHub page, look near the top-right of the file content area
2. Click the button labeled Raw — this shows the plain text

Step 3 — Select and copy all the text

1. Click anywhere on the page, then:
   • Mac: Press Cmd+A (selects all), then Cmd+C (copies)
   • Windows: Press Ctrl+A (selects all), then Ctrl+C (copies)

Step 4 — Create a new Gem

1. Open gemini.google.com in your browser
2. In the left sidebar, click Gem manager
3. Click New Gem (or Create Gem)

Step 5 — Name the Gem

Type a name that matches the skill, like “Analyze Workflows”.

Step 6 — Paste the instructions

1. Click inside the large Instructions text box
2. Paste the text you copied:
   • Mac: Press Cmd+V
   • Windows: Press Ctrl+V

Step 7 — Save the Gem

Click Save.

Step 8 — Use the Gem

1. Find your new Gem in the left sidebar and click it to open a conversation
2. Type:

Help me analyze where AI fits in my work

Gemini will follow the skill’s structured interview process.

Step 9 — Add more Gems later

Repeat these steps for Deconstruct (Step 2). Create additional Gems as you progress through the framework.

About file saving

When a skill says it will “save output to a file,” Gemini will show the output in the chat instead. Copy and save it yourself.

M365 Copilot — ✅ Native skill support (via Copilot Cowork)

M365 Copilot now natively supports Agent Skills through Copilot Cowork. Cowork reads SKILL.md files directly from a folder on your OneDrive — no plugin install or paste step required. Each skill loads automatically when relevant to your conversation.

Official docs: Cowork skills (Microsoft Learn)

What you need first: An M365 Copilot license and enrollment in the Frontier preview program (Cowork is currently a Frontier preview feature). Ask your IT admin if you’re not sure whether your tenant is enrolled.

Step 1 — Open OneDrive

Open OneDrive in whichever way is easiest:

• Windows: Open File Explorer → click OneDrive in the left sidebar
• Mac: Open Finder → click OneDrive in the sidebar (install the OneDrive app if needed)
• Browser: Go to onedrive.live.com and sign in with your Microsoft 365 account

Step 2 — Create the Cowork Skills folder

Inside Documents/, create the path Cowork/Skills/ if it doesn’t already exist:

1. Open the Documents folder
2. Create a new folder named Cowork
3. Open Cowork and create a new folder inside it named Skills

The full path should now be Documents/Cowork/Skills/.

Step 3 — Create a folder for the Analyze skill

Inside Documents/Cowork/Skills/, create a new folder named analyze.

Step 4 — Download the SKILL.md

1. Scroll down to the Skill Files table on this page
2. Click the SKILL.md link for Analyze — this opens GitHub
3. Right-click the Raw button (top-right of the file content area) and choose Save link as…
4. Name the file SKILL.md and save it inside the Documents/Cowork/Skills/analyze/ folder you just created

If your browser doesn’t show a Save link as… option, click Raw, then copy all the text on the page and paste it into a new plain-text file named SKILL.md inside the same folder.

Step 5 — Test it

1. Open M365 Copilot Cowork and start a new conversation

2. Type:

   Help me analyze where AI fits in my work

3. Cowork loads the skill automatically. You’ll see it appear as a chip in the side panel Skills section, and Cowork follows the skill’s structured interview.

Step 6 — Add more skills

Repeat Steps 3–4 for Deconstruct (Step 2) and any other framework skill you need. Each skill goes in its own subfolder under Documents/Cowork/Skills/.

Limits

You can create up to 20 custom skills, and each SKILL.md can be up to 1 MB.

---

Code Editors & Terminal

Use AI through a code editor or terminal? Find your tool and click to expand.

Claude Code (Terminal) — ✅ Native skill support

Claude Code in the terminal has full plugin and skill support. One command installs all 7 skills plus the orchestrator agent.

Official docs: Extend Claude with Skills · Discover and Install Plugins

What you need first: Claude Code installed and running in your terminal, with a Claude Pro, Max, Team, or Enterprise subscription. If you haven’t installed Claude Code yet, see the Claude Code setup guide.

Step 1 — Add the marketplace (one-time setup)

In your Claude Code session, type this command and press Enter:

/plugin marketplace add jamesgray-ai/handsonai-plugins

This tells Claude Code where to find the skills. You only need to do this once — it’s remembered across sessions.

Step 2 — Install the plugin

Type this command and press Enter:

/plugin install handsonai@handsonai

This downloads and installs all 7 skills plus the orchestrator agent.

Step 3 — Verify it worked

Type /plugin list and press Enter. You should see handsonai in the list with all its skills.

Step 4 — Test it

Type /handsonai:analyze and press Enter. The Analyze skill should start running and begin asking you questions. You can also just type “Help me analyze AI workflow opportunities” and Claude will activate the right skill automatically.

For updates, uninstalling, and troubleshooting, see Using Plugins.

Cursor — ✅ Native skill support

Cursor reads Agent Skill files from your project folder automatically.

Official docs: Agent Skills — Cursor

What you need first: Cursor installed and a project folder open. If you haven’t installed Cursor yet, see the Editor Setup guide for step-by-step instructions. Your project root is the top-level folder you have open in Cursor — this is where Cursor looks for skills.

Step 1 — Download a skill

1. Open the skill downloads page in your web browser
2. Scroll down to the Assets section — you’ll see a list of .zip files, one for each skill
3. Click analyze.zip to download it (start with Analyze — it’s Step 1 of the framework)

The file downloads to your computer (usually to your Downloads folder). You can download multiple skills at once if you like.

Step 2 — Extract (unzip) the file

1. Find analyze.zip in your Downloads folder
2. Double-click it — this creates a folder called analyze containing the skill file

Step 3 — Create the skills directory in your project

1. Open your project folder (the one you have open in Cursor) in Finder (Mac) or File Explorer (Windows)
2. Create a new folder called .agents inside your project folder
3. Inside .agents, create another folder called skills
4. You should now have: your-project/.agents/skills/

Can’t see the folder?

On Mac, folders starting with . are hidden by default. In Finder, press Cmd+Shift+. (period key) to show hidden folders.

Step 4 — Move the skill folder into your project

Move (or copy) the analyze folder from Step 2 into the .agents/skills/ folder you just created. You should now have: your-project/.agents/skills/analyze/SKILL.md

Step 5 — Restart Cursor

Close and reopen Cursor (or reopen your project). Cursor discovers skills automatically when they’re in the right folder.

Step 6 — Test it

In Cursor’s chat, type: “Use the analyze skill to help me find AI workflow opportunities.”

Step 7 — Add more skills

Go back to the skill downloads page and download the next skill you need. Repeat Steps 2–4 for each one.

Framework Step	Skill	Direct download
1	Analyze	analyze.zip
2	Deconstruct	deconstruct.zip
3	Design	design.zip
4	Build	build.zip
5	Test	test.zip
6	Run	run.zip
7	Improve	improve.zip

Cross-platform shortcut

The .agents/skills/ folder is recognized by Cursor, Codex CLI, Gemini CLI, and VS Code Copilot — place skills there to share them across tools.

OpenAI Codex — ✅ Native skill support

OpenAI Codex reads Agent Skill files from your project folder automatically. This works across all Codex environments — the CLI, desktop app, and IDE extension (VS Code, Cursor).

Official docs: Agent Skills — Codex

What you need first: OpenAI Codex installed (CLI, desktop app, or IDE extension). If you haven’t set it up yet, see Getting Started with OpenAI for installation steps. Your project root is the top-level folder you’re working in — the folder open in your editor or that you navigated to in your terminal.

Step 1 — Download a skill

1. Open the skill downloads page in your web browser
2. Scroll down to the Assets section — you’ll see a list of .zip files, one for each skill
3. Click analyze.zip to download it (start with Analyze — it’s Step 1 of the framework)

The file downloads to your computer (usually to your Downloads folder). You can download multiple skills at once if you like.

Step 2 — Extract (unzip) the file

Double-click analyze.zip in your Downloads folder — this creates a folder called analyze containing the skill file.

Step 3 — Create the skills directory in your project

In your project folder, create a .agents/skills/ directory. From a terminal you can run:

mkdir -p .agents/skills

Or create the folders manually in Finder/File Explorer: create a folder called .agents inside your project, then create skills inside that.

Step 4 — Move the skill folder into your project

Move (or copy) the analyze folder from Step 2 into .agents/skills/ in your project. You should now have: your-project/.agents/skills/analyze/SKILL.md

Step 5 — Test it

Open your project in Codex (CLI, desktop app, or IDE extension) and say: “Use the analyze skill to help me find AI workflow opportunities.” Codex discovers skills automatically.

Step 6 — Add more skills

Go back to the skill downloads page and download the next skill you need. Repeat Steps 2–4 for each one.

Framework Step	Skill	Direct download
1	Analyze	analyze.zip
2	Deconstruct	deconstruct.zip
3	Design	design.zip
4	Build	build.zip
5	Test	test.zip
6	Run	run.zip
7	Improve	improve.zip

Gemini CLI / Antigravity — ✅ Native skill support

Google’s developer tools — Gemini CLI (command-line) and Antigravity (AI-native IDE) — both read Agent Skill files from your project folder automatically. (For the Gemini web app, see the Google Gemini (app) section above under Chat & Desktop.)

Official docs: Agent Skills — Gemini CLI · Getting Started with Antigravity Skills

What you need first: Gemini CLI or Antigravity installed. If you haven’t set these up yet, see Getting Started with Google Gemini for Gemini CLI installation, or download Antigravity from antigravity.google. Your project root is the top-level folder you’re working in — the folder open in Antigravity or that you navigated to in your terminal.

Step 1 — Download a skill

1. Open the skill downloads page in your web browser
2. Scroll down to the Assets section — you’ll see a list of .zip files, one for each skill
3. Click analyze.zip to download it (start with Analyze — it’s Step 1 of the framework)

The file downloads to your computer (usually to your Downloads folder). You can download multiple skills at once if you like.

Step 2 — Extract (unzip) the file

Double-click analyze.zip in your Downloads folder — this creates a folder called analyze containing the skill file.

Step 3 — Create the skills directory in your project

In your project folder, create a .gemini/skills/ directory. From a terminal you can run:

mkdir -p .gemini/skills

Or create the folders manually in Finder/File Explorer: create a folder called .gemini inside your project, then create skills inside that.

Cross-platform alternative

You can also use .agents/skills/ instead — both Gemini CLI and Antigravity recognize it, and it’s also compatible with Cursor, Codex, and VS Code Copilot.

Step 4 — Move the skill folder into your project

Move (or copy) the analyze folder from Step 2 into .gemini/skills/ (or .agents/skills/) in your project. You should now have: your-project/.gemini/skills/analyze/SKILL.md

Step 5 — Test it

Open your project in Gemini CLI or Antigravity and say: “Use the analyze skill to help me find AI workflow opportunities.” Skills are discovered automatically.

Step 6 — Add more skills

Go back to the skill downloads page and download the next skill you need. Repeat Steps 2–4 for each one.

Framework Step	Skill	Direct download
1	Analyze	analyze.zip
2	Deconstruct	deconstruct.zip
3	Design	design.zip
4	Build	build.zip
5	Test	test.zip
6	Run	run.zip
7	Improve	improve.zip

---

Using a different tool (VS Code Copilot, Perplexity, or another platform)? See How to Add Skills to Your Platform for additional platforms.

Skill Files

These are the direct links to each skill’s instruction file on GitHub. Used by the ChatGPT, Gemini, and M365 Copilot Cowork setup instructions above — and useful for any platform where you need to copy or download the skill text.

How to copy a skill: Click the SKILL.md link → click the Raw button (top-right of the file) → select all text (Cmd+A on Mac, Ctrl+A on Windows) → copy (Cmd+C / Ctrl+C).

Step	Skill	File
1	Analyze	SKILL.md
2	Deconstruct	SKILL.md
3	Design	SKILL.md
4	Build	SKILL.md
5	Test	SKILL.md
6	Run	SKILL.md
7	Improve	SKILL.md

About the Build skill

The Build skill (Step 4) also has reference files that it uses. On platforms with native skill support (Claude, Cursor, Codex CLI, Gemini CLI), these are included automatically. M365 Copilot Cowork’s documented format only describes a single SKILL.md per skill folder, so until Microsoft documents reference-file support you’ll need to paste the references/agent-spec.md and references/skill-spec.md contents into the body of SKILL.md after the main instructions. On paste-based platforms (ChatGPT Projects, Gems), copy and paste the references/agent-spec.md and references/skill-spec.md files after the SKILL.md content when you set up Build.

Update the Skills

Skills and the framework-agent evolve as the methodology improves — new skills get added, prompts get refined, reference material gets sharper. Here’s how to pull the latest versions on your platform. Check the release notes on GitHub to see what changed before you update.

Claude Chat (claude.ai)

Re-uploading a skill replaces the existing version — no need to remove it first.

1. Re-download the latest ZIP from GitHub Releases.
2. In Claude.ai, click Customize in the left sidebar → Skills → + → Create skill → Upload skill, and select the new .zip. It replaces the existing skill of the same name.

Only refresh the skills you actively use — there’s no need to update every skill on every release.

Claude Cowork (Desktop App)

Refreshing in Cowork is a two-step process: the marketplace and the installed plugin are tracked separately, so checking for updates is not the same as installing them.

Step 1 — Check the marketplace for updates

In Cowork → Customize → Browse plugins → Personal tab, click the … menu on the handsonai-plugins marketplace chip and choose Check for updates. This pulls the latest commit from GitHub.

Step 2 — Apply the update to the installed plugin

Open the Handsonai plugin in your Personal plugins list. In the Customize panel that opens, click the Update button in the top-right. The new skills and agent are available immediately — no restart required.

Auto-sync the marketplace

Toggle Sync automatically in the same menu from Step 1 to let Cowork check GitHub on launch. You’ll still click Update in Step 2 when a new version is available — auto-sync only handles the “check” step, not the install.

Claude Code (Desktop App or Terminal)

In the Code tab (or your terminal), run:

/plugin update handsonai@handsonai

Or update every installed plugin at once:

/plugin update --all

Enable auto-updates so the marketplace refreshes on startup. Run /plugin → Marketplaces tab → handsonai → Enable auto-update. See the full walkthrough in Using Plugins → Enabling auto-updates.

ChatGPT

Native Skills: Re-download the latest ZIP from GitHub Releases and upload it again — re-uploading replaces the existing skill of the same name.

OpenAI Codex in an editor: Follow the Cursor / Codex / Gemini CLI instructions below.

M365 Copilot (Cowork)

Cowork reads SKILL.md directly from OneDrive, so updating is a file overwrite.

1. On the Skill Files table above, click the SKILL.md link for the skill you want to update.
2. Click Raw, then save (right-click → Save link as…) over the existing file at Documents/Cowork/Skills/<skill>/SKILL.md.

Cowork picks up the change on your next conversation.

Cursor, OpenAI Codex, Gemini CLI / Antigravity

All four tools read skills from a project folder. Refreshing means swapping the folder.

1. Re-download the latest skill ZIP from GitHub Releases.
2. Unzip it. In your project, replace the existing skill folder under .agents/skills/<skill>/ (or .gemini/skills/<skill>/ for Gemini) with the new one.
3. Restart the tool if it caches skill metadata (Cursor and Antigravity usually require a reopen; CLIs pick up changes on the next session).

Using These Skills

Once you’ve installed or set up the skills for your platform, here’s how to use them:

Platform	How to start
Claude Chat	Start a new chat. Claude uses your installed skills automatically. Say “Help me analyze AI workflow opportunities.”
Claude Cowork (Desktop App)	Describe what you need. Cowork activates the right skill automatically.
Claude Code (Desktop App)	Type /handsonai:analyze in the Code tab, or describe your need. Same commands as the terminal.
Claude Code (Terminal)	Type /handsonai:analyze (or any slash command below). Or just describe your need — Claude picks the skill.
ChatGPT	Open the Project you created for the skill. Type your request.
Google Gemini (app)	Click the Gem in your sidebar. Type your request.
M365 Copilot	Start a Cowork conversation. Type your request — Cowork loads the matching skill from OneDrive automatically.
Cursor / OpenAI Codex / Gemini CLI / Antigravity	Ask by skill name — e.g., “Use the analyze skill.” Skills are discovered automatically.

Claude Code slash commands:

Command	Skill
/handsonai:analyze	Analyze — Step 1
/handsonai:deconstruct	Deconstruct — Step 2
/handsonai:design	Design — Step 3
/handsonai:build	Build — Step 4
/handsonai:test	Test — Step 5
/handsonai:run	Run — Step 6
/handsonai:improve	Improve — Step 7

What Each Skill Does

Each skill is documented in detail on its step page — including the run sequence, example prompts, and outputs. This page focuses on installation; the step pages are the single source of truth for what each skill actually does.

Skill	Step page
analyze	Step 1 — Analyze
deconstruct	Step 2 — Deconstruct
design	Step 3 — Design
build	Step 4 — Build
test	Step 5 — Test
run	Step 6 — Run
improve	Step 7 — Improve
framework-agent	Run It All at Once: framework-agent — orchestrates all seven skills end-to-end

FAQ

What if I lose context mid-conversation? The file-based handoffs between steps mean you can continue in a new conversation. Just invoke the next skill and point it at the file from the previous step (e.g., “Use deconstruct on outputs/lead-qualification-requirements.md”).

Do I need Claude Code for all of this? No. These skills work on Claude.ai, Claude Cowork, Claude Code, ChatGPT, Google Gemini, M365 Copilot, Cursor, OpenAI Codex, Gemini CLI, and Antigravity. See Set Up These Skills above for step-by-step setup instructions for your specific platform.