This repo contains the agent skills for JOYCO.
pnpx skills add joyco-studio/skills| Skill | Description |
|---|---|
| joyco-app | Carry a new JOYCO internal Next.js product app from plan to working build: lock a plan first, run the opinionated kickoff (JOYCO UI shadcn kit — theme, fonts, @joyco/* components from hub.joyco.studio — plus lint config and the Claude Code agent), then build it out to the plan. User-invocable as /joyco-app. |
| joyco-logs | Before implementing or planning a non-trivial feature, check the JOYCO dev-team logs (hub.joyco.studio/logs) for a relevant write-up and read it first. Surfaces the team's gotchas/patterns, defers to dedicated skills on overlap, and credits the source article to the user. |
| lab-experiment | Automates extracting self-contained experiments from any codebase, scaffolding with JOYCO templates, deploying to Vercel, and publishing to the JOYCO Lab registry. Handles 3D, animation, and interactive code experiments. |
| parallel-claudes | Guide for running multiple parallel Claude Code sessions using cw (Claude Worktree Manager). Covers git worktree management, concurrent AI coding tasks, and merging results. |
| pr-description-writer | Generate high-quality PR descriptions in Markdown. Supports issue, feature, and big-feature PR types with structured, production-ready output. |
| markdown-content | Guide for building markdown content pages in Next.js using fumadocs-mdx, rehype-pretty-code, and shiki. Covers MDX collections, prose typography, code blocks, and component consistency. |
| thrash-report-analyzer | Analyze a bye-thrash layout thrashing report array. Parses stack traces, identifies user-code functions causing forced reflows, locates the offending style-write → layout-read pairs in source files, and produces fix suggestions. |
| trace-audit | Analyze a Chrome DevTools Performance trace JSON file for performance anomalies, producing a structured audit report with critical issues, warnings, metrics, timeline hotspots, and actionable recommendations. |
| webaudio | Add sound effects, UI audio, and ambient sound to a web app using @joycostudio/suno. Picks the right entry point (vanilla vs React, with/without Mixer), writes a typed manifest, and wires an unlock gesture. |
| skill-writer | Author or refactor a skill in this repo. Covers frontmatter conventions, file layout, and the rule for splitting deep reference material into linked sibling docs instead of bloating SKILL.md. |
| react-ts-debugging | Debug React and TypeScript bugs through a collaborative, log-driven loop with the developer instead of guessing from source code. Strategic console logs drive each next step. |
| resolving-git-conflicts | Diagnose and resolve git conflicts of any kind — merge, rebase, cherry-pick, stash, revert. Detects phantom conflicts from squash merges or rewritten history and picks the right git strategy instead of hand-editing markers. |
| joyco-ui | Use the JOYCO UI kit correctly when building interfaces. A thin router that sends Claude to the live hub docs and installed source (cluster.md, the @joyco registry, the component .tsx) instead of restating the API, so it never goes stale. Pairs with joyco-app. |