Markdown Converter
Agent skill for markdown-converter
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Sign in to like and favorite skills
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Repository for bug reproductions across Nuxt ecosystem libraries. Each subdirectory is a minimal project demonstrating a specific issue.
Source code for maintained libraries lives in
~/nuxt/:
~/nuxt/content - Nuxt Content~/nuxt/hub - NuxtHubUse the
vue, nuxt, and nuxthub skills when working in this repo.
{library}-{issue-number} (e.g., nuxthub-727){library}-{issue-number}-fixed (e.g., nuxthub-727-fixed).gitignore with: node_modules, .data, .nuxt, .outputVerification can be:
.nuxt/, dist/, or build outputDocument the verification method in README.
Note: If the target repo has existing tests, try to reproduce the bug with a test first. This helps maintainers and ensures the fix is properly validated.
-fixed versionpnpm patch {package}pnpm patch-commit {path}Each repro folder README should contain:
# {library}-{issue-number} Issue: {link-to-github-issue} ## Problem {Brief description} ## Verify ```bash pnpm i && pnpm build
{What should happen}
{What actually happens}
For `-fixed` folders, add: ```md ## Fix {What the patch changes}
cd ~/repros git add {folder-name} {folder-name}-fixed git commit -m "add {library}-{issue} repro" git push
fix/{short-description}Closes #{issue-number} ## Summary {1-2 sentences explaining the bug and fix} ## StackBlitz | | Link | Expected | |---|---|---| | Bug | [{library}-{issue}](https://stackblitz.com/github/onmax/repros/tree/main/{library}-{issue}?startScript=build) | ❌ Build fails | | Fix | [{library}-{issue}-fixed](https://stackblitz.com/github/onmax/repros/tree/main/{library}-{issue}-fixed?startScript=build) | ✅ Build succeeds | ## CLI Reproduction ```bash git clone --depth 1 --filter=blob:none --sparse https://github.com/onmax/repros.git cd repros && git sparse-checkout set {library}-{issue} cd {library}-{issue} && pnpm i && pnpm build
git sparse-checkout add {library}-{issue}-fixed cd ../{library}-{issue}-fixed && pnpm i && pnpm build
The
-fixed folder uses pnpm patch to apply the fix locally.
### 4. Commit Message - Follow repo conventions (check recent commits) - Common format: `{type}({scope}): {description}` - Examples: `fix(db): pass mode to drizzle for mysql` ### 5. After PR Submission - Wait for CI to pass - Address any failing checks before requesting review - If CI fails, fix and push to same branch --- ## Quick Reference Commands ```bash # Create pnpm patch pnpm patch {package} pnpm patch-commit '{extracted-path}' # Sparse checkout for repro git clone --depth 1 --filter=blob:none --sparse https://github.com/onmax/repros.git cd repros && git sparse-checkout set {folder-name} # StackBlitz URLs (with auto-install and build) # Bug: https://stackblitz.com/github/onmax/repros/tree/main/{library}-{issue}?startScript=build # Fix: https://stackblitz.com/github/onmax/repros/tree/main/{library}-{issue}-fixed?startScript=build # # startScript param runs the script from package.json after install # Other useful params: terminal=true, file=path/to/file.ts # Create PR gh pr create --repo {org}/{repo} --title "{title}" --body "{body}"