aico-cli 2.1.7 → 2.1.23

package/templates/skills/antfu/references/app-development.md

@@ -0,0 +1,60 @@
+---
+name: app-development
+description: Anthony Fu's preferences for building web applications with Vue, Vite/Nuxt, and UnoCSS
+---
+
+# App Development Preferences
+
+Preferences for building web applications.
+
+## Stack Overview
+
+| Aspect | Choice |
+|--------|--------|
+| Framework | Vue 3 (Composition API) |
+| Build Tool | Vite (SPA) or Nuxt (SSR/SSG) |
+| Styling | UnoCSS |
+| Utilities | VueUse |
+
+---
+
+## Framework Selection
+
+| Use Case | Choice |
+|----------|--------|
+| SPA, client-only, library playgrounds | Vite + Vue |
+| SSR, SSG, SEO-critical, file-based routing, API routes | Nuxt |
+
+---
+
+## Vue Conventions
+
+| Convention | Preference |
+|------------|------------|
+| Script syntax | Always `<script setup lang="ts">` |
+| State | Prefer `shallowRef()` over `ref()` |
+| Objects | Use `ref()`, avoid `reactive()` |
+
+### Props and Emits
+
+Use TypeScript interfaces:
+
+```vue
+<script setup lang="ts">
+interface Props {
+  title: string
+  count?: number
+}
+
+interface Emits {
+  (e: 'update', value: number): void
+  (e: 'close'): void
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  count: 0,
+})
+
+const emit = defineEmits<Emits>()
+</script>
+```

package/templates/skills/antfu/references/github-actions.md

@@ -0,0 +1,68 @@
+---
+name: github-actions
+description: Anthony Fu's preferred GitHub Actions workflows using sxzz/workflows
+---
+
+# GitHub Actions
+
+When setting up a new project, add these workflows. Skip if workflows already exist.
+
+## Autofix Workflow
+
+**`.github/workflows/autofix.yml`** - Auto-fix linting on PRs:
+
+```yaml
+name: autofix.ci
+
+on: [pull_request]
+
+jobs:
+  autofix:
+    uses: sxzz/workflows/.github/workflows/autofix.yml@v1
+    permissions:
+      contents: read
+```
+
+## Unit Test Workflow
+
+**`.github/workflows/unit-test.yml`** - Run tests on push/PR:
+
+```yaml
+name: Unit Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions: {}
+
+jobs:
+  unit-test:
+    uses: sxzz/workflows/.github/workflows/unit-test.yml@v1
+```
+
+## Release Workflow
+
+**`.github/workflows/release.yml`** - Publish on tag (library projects only):
+
+```yaml
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    uses: sxzz/workflows/.github/workflows/release.yml@v1
+    with:
+      publish: true
+    permissions:
+      contents: write
+      id-token: write
+```
+
+All workflows use [sxzz/workflows](https://github.com/sxzz/workflows) reusable workflows.

package/templates/skills/antfu/references/gitignore.md

@@ -0,0 +1,29 @@
+---
+name: gitignore
+description: Anthony Fu's preferred .gitignore for JavaScript/TypeScript projects
+---
+
+# .gitignore
+
+When `.gitignore` is not present, create it with:
+
+```
+*.log
+*.tgz
+.cache
+.DS_Store
+.eslintcache
+.idea
+.env
+.nuxt
+.temp
+.output
+.turbo
+cache
+coverage
+dist
+lib-cov
+logs
+node_modules
+temp
+```

package/templates/skills/antfu/references/library-development.md

@@ -0,0 +1,85 @@
+---
+name: library-development
+description: Anthony Fu's preferences for building and publishing JavaScript/TypeScript libraries
+---
+
+# Library Development Preferences
+
+Preferences for bundling and publishing TypeScript libraries.
+
+## Key Decisions
+
+| Aspect | Choice |
+|--------|--------|
+| Bundler | tsdown |
+| Output | Pure ESM only (no CJS) |
+| DTS | Generated via tsdown |
+| Exports | Auto-generated via tsdown |
+
+---
+
+## tsdown Configuration
+
+Use tsdown with these options enabled:
+
+```ts
+// tsdown.config.ts
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  exports: true,
+})
+```
+
+| Option | Value | Purpose |
+|--------|-------|---------|
+| `format` | `['esm']` | Pure ESM, no CommonJS |
+| `dts` | `true` | Generate `.d.ts` files |
+| `exports` | `true` | Auto-update `exports` field in `package.json` |
+
+### Multiple Entry Points
+
+```ts
+export default defineConfig({
+  entry: [
+    'src/index.ts',
+    'src/utils.ts',
+  ],
+  format: ['esm'],
+  dts: true,
+  exports: true,
+})
+```
+
+The `exports: true` option auto-generates the `exports` field in `package.json` when running `tsdown`.
+
+---
+
+## package.json
+
+Required fields for pure ESM library:
+
+```json
+{
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsdown",
+    "prepack": "pnpm build",
+    "test": "vitest",
+    "release": "bumpp -r"
+  }
+}
+```
+
+The `exports` field is managed by tsdown when `exports: true`.
+
+### prepack Script
+
+For each public package, add `"prepack": "pnpm build"` to `scripts`. This ensures the package is automatically built before publishing (e.g., when running `npm publish` or `pnpm publish`). This prevents accidentally publishing stale or missing build artifacts.

package/templates/skills/antfu/references/monorepo.md

@@ -0,0 +1,126 @@
+---
+name: monorepo
+description: Anthony Fu's monorepo setup conventions using pnpm workspaces
+---
+
+# Monorepo Setup
+
+Conventions for setting up and managing monorepos.
+
+## pnpm Workspaces
+
+Use pnpm workspaces for monorepo management:
+
+```yaml
+# pnpm-workspace.yaml
+packages:
+  - 'packages/*'
+```
+
+## Scripts Convention
+
+Have scripts in each package, and use `-r` (recursive) flag at root,
+Enable ESLint cache for faster linting in monorepos.
+
+```json
+// root package.json
+{
+  "scripts": {
+    "build": "pnpm run -r build",
+    "test": "vitest",
+    "lint": "eslint . --cache --concurrency=auto"
+  }
+}
+```
+
+In each package's `package.json`, add the scripts.
+
+```json
+// packages/*/package.json
+{
+  "scripts": {
+    "build": "tsdown",
+    "prepack": "pnpm build"
+  }
+}
+```
+
+## ESLint Cache
+
+
+```json
+{
+  "scripts": {
+    "lint": "eslint . --cache --concurrency=auto"
+  }
+}
+```
+
+## Turborepo (Optional)
+
+For monorepos with many packages or long build times, use Turborepo for task orchestration and caching.
+
+See the dedicated Turborepo skill for detailed configuration.
+
+## Centralized Alias
+
+For better DX across Vite, Nuxt, Vitest configs, create a centralized `alias.ts` at project root:
+
+```ts
+// alias.ts
+import fs from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { join, relative } from 'pathe'
+
+const root = fileURLToPath(new URL('.', import.meta.url))
+const r = (path: string) => fileURLToPath(new URL(`./packages/${path}`, import.meta.url))
+
+export const alias = {
+  '@myorg/core': r('core/src/index.ts'),
+  '@myorg/utils': r('utils/src/index.ts'),
+  '@myorg/ui': r('ui/src/index.ts'),
+  // Add more aliases as needed
+}
+
+// Auto-update tsconfig.alias.json paths
+const raw = fs.readFileSync(join(root, 'tsconfig.alias.json'), 'utf-8').trim()
+const tsconfig = JSON.parse(raw)
+tsconfig.compilerOptions.paths = Object.fromEntries(
+  Object.entries(alias).map(([key, value]) => [key, [`./${relative(root, value)}`]]),
+)
+const newRaw = JSON.stringify(tsconfig, null, 2)
+if (newRaw !== raw)
+  fs.writeFileSync(join(root, 'tsconfig.alias.json'), `${newRaw}\n`, 'utf-8')
+```
+
+Then update the `tsconfig.json` to use the alias file:
+
+```json
+{
+  "extends": [
+    "./tsconfig.alias.json"
+  ]
+}
+```
+
+### Using Alias in Configs
+
+Reference the centralized alias in all config files:
+
+```ts
+// vite.config.ts
+import { alias } from './alias'
+
+export default defineConfig({
+  resolve: { alias },
+})
+```
+
+```ts
+// nuxt.config.ts
+import { alias } from './alias'
+
+export default defineNuxtConfig({
+  alias,
+})
+```

package/templates/skills/antfu/references/vscode-extensions.md

@@ -0,0 +1,34 @@
+---
+name: vscode-extensions
+description: Recommended VS Code extensions
+---
+
+# VS Code Extensions
+
+## Recommended Extensions
+
+Configure in `.vscode/extensions.json` (choose based on the needs):
+
+```json
+{
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "antfu.pnpm-catalog-lens",
+    "antfu.iconify",
+    "antfu.unocss",
+    "antfu.slidev",
+    "vue.volar"
+  ]
+}
+```
+
+## Extension Details
+
+| Extension | Description |
+|-----------|-------------|
+| `dbaeumer.vscode-eslint` | ESLint integration for linting and formatting |
+| `antfu.pnpm-catalog-lens` | Shows pnpm catalog version hints inline |
+| `antfu.iconify` | Iconify icon preview and autocomplete |
+| `antfu.unocss` | UnoCSS IntelliSense and syntax highlighting |
+| `antfu.slidev` | Slidev preview and syntax highlighting for presentations |
+| `vue.volar` | Vue Language Features (official Vue extension) |

package/templates/skills/nuxt/GENERATION.md

@@ -0,0 +1,5 @@
+# Generation Info
+
+- **Source:** `sources/nuxt`
+- **Git SHA:** `c9fed804b9bef362276033b03ca43730c6efa7dc`
+- **Generated:** 2026-01-28

package/templates/skills/nuxt/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: nuxt
+description: Nuxt full-stack Vue framework with SSR, auto-imports, and file-based routing. Use when working with Nuxt apps, server routes, useFetch, middleware, or hybrid rendering.
+metadata:
+  author: Anthony Fu
+  version: "2026.1.28"
+  source: Generated from https://github.com/nuxt/nuxt, scripts located at https://github.com/antfu/skills
+---
+
+Nuxt is a full-stack Vue framework that provides server-side rendering, file-based routing, auto-imports, and a powerful module system. It uses Nitro as its server engine for universal deployment across Node.js, serverless, and edge platforms.
+
+> The skill is based on Nuxt 3.x, generated at 2026-01-28.
+
+## Core
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Directory Structure | Project folder structure, conventions, file organization | [core-directory-structure](references/core-directory-structure.md) |
+| Configuration | nuxt.config.ts, app.config.ts, runtime config, environment variables | [core-config](references/core-config.md) |
+| CLI Commands | Dev server, build, generate, preview, and utility commands | [core-cli](references/core-cli.md) |
+| Routing | File-based routing, dynamic routes, navigation, middleware, layouts | [core-routing](references/core-routing.md) |
+| Data Fetching | useFetch, useAsyncData, $fetch, caching, refresh | [core-data-fetching](references/core-data-fetching.md) |
+| Modules | Creating and using Nuxt modules, Nuxt Kit utilities | [core-modules](references/core-modules.md) |
+| Deployment | Platform-agnostic deployment with Nitro, Vercel, Netlify, Cloudflare | [core-deployment](references/core-deployment.md) |
+
+## Features
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Composables Auto-imports | Vue APIs, Nuxt composables, custom composables, utilities | [features-composables](references/features-composables.md) |
+| Components Auto-imports | Component naming, lazy loading, hydration strategies | [features-components-autoimport](references/features-components-autoimport.md) |
+| Built-in Components | NuxtLink, NuxtPage, NuxtLayout, ClientOnly, and more | [features-components](references/features-components.md) |
+| State Management | useState composable, SSR-friendly state, Pinia integration | [features-state](references/features-state.md) |
+| Server Routes | API routes, server middleware, Nitro server engine | [features-server](references/features-server.md) |
+
+## Rendering
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Rendering Modes | Universal (SSR), client-side (SPA), hybrid rendering, route rules | [rendering-modes](references/rendering-modes.md) |
+
+## Best Practices
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Data Fetching Patterns | Efficient fetching, caching, parallel requests, error handling | [best-practices-data-fetching](references/best-practices-data-fetching.md) |
+| SSR & Hydration | Avoiding context leaks, hydration mismatches, composable patterns | [best-practices-ssr](references/best-practices-ssr.md) |
+
+## Advanced
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Layers | Extending applications with reusable layers | [advanced-layers](references/advanced-layers.md) |
+| Lifecycle Hooks | Build-time, runtime, and server hooks | [advanced-hooks](references/advanced-hooks.md) |
+| Module Authoring | Creating publishable Nuxt modules with Nuxt Kit | [advanced-module-authoring](references/advanced-module-authoring.md) |