Package a local Claude skill for the web app without carrying private files with it, fix the naming and archive structure, upload it to the intended workspace, and test it with synthetic input.
Source episode · 24:00
Claude Skills Explained: My Workflow for Creating Reusable AI Agents with Cursor and Claude Codewith Claire Vo
Claire zips a locally built skill, fixes its lowercase hyphenated name after the first upload fails, uploads it to Claude, and uses it with customer demo notes.
A minimal skill archive that uploads successfully, appears in the intended Claude workspace, and handles a representative web-chat request.
Anthropic AI assistant
Step by step
Follow the sequence once, then adapt the prompts, checks, and handoffs to your own setup.
4 steps
Copy only the skill files needed at runtime into a clean staging folder. Inspect referenced paths and exclude credentials, customer data, Git history, caches, dependencies, and unrelated examples before creating the zip.
Make the folder name and the name in SKILL.md identical, lowercase, and hyphenated. Run the validator, inspect the archive listing, and rebuild the zip after any change.
Getting the name format right is a common stumbling block. Double-checking this step can save you from a frustrating upload error.
In the intended Claude account or workspace, open the skill-upload control and choose the new archive. Confirm the uploaded name and remove or distinguish any stale copy before testing.
Use synthetic input that has a known expected result. Confirm that Claude selects the skill and follows its output contract, then test one non-matching request to make sure the trigger is not too broad.
Here are synthetic [input type] notes for testing: [input] Use the uploaded [skill-name] skill. Follow its required format and do not add facts that are absent from the notes.
Turn an idea into a PRD, user stories, and a plan.
After the steps
How to recover when the loop fails and where human judgment helps.
Recover
Keep building
Log your workouts effortlessly without ever opening a spreadsheet. This workflow uses the Claude mobile app to parse a simple voice note and automatically update your workout tracking spreadsheet in the background.
Create a custom email management interface within Claude to read, triage, and draft replies without opening the Gmail tab. This workflow helps you reclaim focus and compound your learnings by training your AI on every interaction.
Build a fully automated system in Claude to generate personalized, interactive HTML proposals and client onboarding materials, saving hours on administrative work and creating a high-touch experience.
Join 100,000+ product managers who use ChatPRD to write better docs, align teams faster, and build products users love.