fix formatting errors

Author: barrymichaeldoyle

.agents/skills/convex-create-component/SKILL.md

@@ -66,35 +66,35 @@ A minimal local component with a table and two functions, plus the app wiring.
 
 ```ts
 // convex/components/notifications/convex.config.ts
-import { defineComponent } from "convex/server";
+import { defineComponent } from 'convex/server';
 
-export default defineComponent("notifications");
+export default defineComponent('notifications');
 ```
 
 ```ts
 // convex/components/notifications/schema.ts
-import { defineSchema, defineTable } from "convex/server";
-import { v } from "convex/values";
+import { defineSchema, defineTable } from 'convex/server';
+import { v } from 'convex/values';
 
 export default defineSchema({
   notifications: defineTable({
     userId: v.string(),
     message: v.string(),
     read: v.boolean(),
-  }).index("by_user", ["userId"]),
+  }).index('by_user', ['userId']),
 });
 ```
 
 ```ts
 // convex/components/notifications/lib.ts
-import { v } from "convex/values";
-import { mutation, query } from "./_generated/server.js";
+import { v } from 'convex/values';
+import { mutation, query } from './_generated/server.js';
 
 export const send = mutation({
   args: { userId: v.string(), message: v.string() },
-  returns: v.id("notifications"),
+  returns: v.id('notifications'),
   handler: async (ctx, args) => {
-    return await ctx.db.insert("notifications", {
+    return await ctx.db.insert('notifications', {
       userId: args.userId,
       message: args.message,
       read: false,
@@ -106,7 +106,7 @@ export const listUnread = query({
   args: { userId: v.string() },
   returns: v.array(
     v.object({
-      _id: v.id("notifications"),
+      _id: v.id('notifications'),
       _creationTime: v.number(),
       userId: v.string(),
       message: v.string(),
@@ -115,18 +115,18 @@ export const listUnread = query({
   ),
   handler: async (ctx, args) => {
     return await ctx.db
-      .query("notifications")
-      .withIndex("by_user", (q) => q.eq("userId", args.userId))
-      .filter((q) => q.eq(q.field("read"), false))
+      .query('notifications')
+      .withIndex('by_user', (q) => q.eq('userId', args.userId))
+      .filter((q) => q.eq(q.field('read'), false))
       .collect();
   },
 });
 ```
 
 ```ts
 // convex/convex.config.ts
-import { defineApp } from "convex/server";
-import notifications from "./components/notifications/convex.config.js";
+import { defineApp } from 'convex/server';
+import notifications from './components/notifications/convex.config.js';
 
 const app = defineApp();
 app.use(notifications);
@@ -136,17 +136,17 @@ export default app;
 
 ```ts
 // convex/notifications.ts  (app-side wrapper)
-import { v } from "convex/values";
-import { mutation, query } from "./_generated/server";
-import { components } from "./_generated/api";
-import { getAuthUserId } from "@convex-dev/auth/server";
+import { v } from 'convex/values';
+import { mutation, query } from './_generated/server';
+import { components } from './_generated/api';
+import { getAuthUserId } from '@convex-dev/auth/server';
 
 export const sendNotification = mutation({
   args: { message: v.string() },
   returns: v.null(),
   handler: async (ctx, args) => {
     const userId = await getAuthUserId(ctx);
-    if (!userId) throw new Error("Not authenticated");
+    if (!userId) throw new Error('Not authenticated');
 
     await ctx.runMutation(components.notifications.lib.send, {
       userId,
@@ -160,7 +160,7 @@ export const myUnread = query({
   args: {},
   handler: async (ctx) => {
     const userId = await getAuthUserId(ctx);
-    if (!userId) throw new Error("Not authenticated");
+    if (!userId) throw new Error('Not authenticated');
 
     return await ctx.runQuery(components.notifications.lib.listUnread, {
       userId,
@@ -196,7 +196,7 @@ const apiKey = process.env.OPENAI_API_KEY;
 ```ts
 // Good: the app resolves auth and env, then passes explicit values
 const userId = await getAuthUserId(ctx);
-if (!userId) throw new Error("Not authenticated");
+if (!userId) throw new Error('Not authenticated');
 
 await ctx.runAction(components.translator.translate, {
   userId,
@@ -219,7 +219,7 @@ export const sendNotification = mutation({
   returns: v.null(),
   handler: async (ctx, args) => {
     const userId = await getAuthUserId(ctx);
-    if (!userId) throw new Error("Not authenticated");
+    if (!userId) throw new Error('Not authenticated');
 
     await ctx.runMutation(components.notifications.lib.send, {
       userId,
@@ -235,7 +235,7 @@ export const sendNotification = mutation({
 ```ts
 // Bad: parent app table IDs are not valid component validators
 args: {
-  userId: v.id("users");
+  userId: v.id('users');
 }
 ```
 

.agents/skills/convex-create-component/agents/openai.yaml

@@ -1,10 +1,10 @@
 interface:
-  display_name: "Convex Create Component"
-  short_description: "Design and build reusable Convex components with clear boundaries."
-  icon_small: "./assets/icon.svg"
-  icon_large: "./assets/icon.svg"
-  brand_color: "#14B8A6"
-  default_prompt: "Help me create a Convex component for this feature. First check that a component is actually justified, then design the tables, API surface, and app-facing wrappers before implementing it."
+  display_name: 'Convex Create Component'
+  short_description: 'Design and build reusable Convex components with clear boundaries.'
+  icon_small: './assets/icon.svg'
+  icon_large: './assets/icon.svg'
+  brand_color: '#14B8A6'
+  default_prompt: 'Help me create a Convex component for this feature. First check that a component is actually justified, then design the tables, API surface, and app-facing wrappers before implementing it.'
 
 policy:
   allow_implicit_invocation: true

.agents/skills/convex-create-component/references/advanced-patterns.md

@@ -8,7 +8,7 @@ When the app needs to pass a callback function to the component, use function ha
 
 ```ts
 // App side: create a handle and pass it to the component
-import { createFunctionHandle } from "convex/server";
+import { createFunctionHandle } from 'convex/server';
 
 export const startJob = mutation({
   handler: async (ctx) => {
@@ -22,14 +22,14 @@ export const startJob = mutation({
 
 ```ts
 // Component side: accept and invoke the handle
-import { v } from "convex/values";
-import type { FunctionHandle } from "convex/server";
-import { mutation } from "./_generated/server.js";
+import { v } from 'convex/values';
+import type { FunctionHandle } from 'convex/server';
+import { mutation } from './_generated/server.js';
 
 export const enqueue = mutation({
   args: { callback: v.string() },
   handler: async (ctx, args) => {
-    const handle = args.callback as FunctionHandle<"mutation">;
+    const handle = args.callback as FunctionHandle<'mutation'>;
     await ctx.scheduler.runAfter(0, handle, {});
   },
 });
@@ -40,19 +40,19 @@ export const enqueue = mutation({
 Instead of manually repeating field types in return validators, extend the schema validator:
 
 ```ts
-import { v } from "convex/values";
-import schema from "./schema.js";
+import { v } from 'convex/values';
+import schema from './schema.js';
 
 const notificationDoc = schema.tables.notifications.validator.extend({
-  _id: v.id("notifications"),
+  _id: v.id('notifications'),
   _creationTime: v.number(),
 });
 
 export const getLatest = query({
   args: {},
   returns: v.nullable(notificationDoc),
   handler: async (ctx) => {
-    return await ctx.db.query("notifications").order("desc").first();
+    return await ctx.db.query('notifications').order('desc').first();
   },
 });
 ```
@@ -78,11 +78,11 @@ export const configure = mutation({
   args: { maxRetries: v.number(), webhookUrl: v.optional(v.string()) },
   returns: v.null(),
   handler: async (ctx, args) => {
-    const existing = await ctx.db.query("globals").first();
+    const existing = await ctx.db.query('globals').first();
     if (existing) {
       await ctx.db.patch(existing._id, args);
     } else {
-      await ctx.db.insert("globals", args);
+      await ctx.db.insert('globals', args);
     }
     return null;
   },
@@ -95,10 +95,10 @@ For components with many functions or configuration options, a class-based clien
 
 ```ts
 // src/client/index.ts
-import type { GenericMutationCtx, GenericDataModel } from "convex/server";
-import type { ComponentApi } from "../component/_generated/component.js";
+import type { GenericMutationCtx, GenericDataModel } from 'convex/server';
+import type { ComponentApi } from '../component/_generated/component.js';
 
-type MutationCtx = Pick<GenericMutationCtx<GenericDataModel>, "runMutation">;
+type MutationCtx = Pick<GenericMutationCtx<GenericDataModel>, 'runMutation'>;
 
 export class Notifications {
   constructor(
@@ -109,19 +109,19 @@ export class Notifications {
   async send(ctx: MutationCtx, args: { userId: string; message: string }) {
     return await ctx.runMutation(this.component.lib.send, {
       ...args,
-      channel: this.options?.defaultChannel ?? "default",
+      channel: this.options?.defaultChannel ?? 'default',
     });
   }
 }
 ```
 
 ```ts
 // App usage
-import { Notifications } from "@convex-dev/notifications";
-import { components } from "./_generated/api";
+import { Notifications } from '@convex-dev/notifications';
+import { components } from './_generated/api';
 
 const notifications = new Notifications(components.notifications, {
-  defaultChannel: "alerts",
+  defaultChannel: 'alerts',
 });
 
 export const send = mutation({

.agents/skills/convex-migration-helper/SKILL.md

@@ -68,9 +68,9 @@ users: defineTable({
 
 ```typescript
 posts: defineTable({
-  userId: v.id("users"),
+  userId: v.id('users'),
   title: v.string(),
-}).index("by_user", ["userId"]);
+}).index('by_user', ['userId']);
 ```
 
 ### Adding Index
@@ -79,7 +79,7 @@ posts: defineTable({
 users: defineTable({
   name: v.string(),
   email: v.string(),
-}).index("by_email", ["email"]);
+}).index('by_email', ['email']);
 ```
 
 ## Breaking Changes: The Deployment Workflow

.agents/skills/convex-migration-helper/agents/openai.yaml

@@ -1,10 +1,10 @@
 interface:
-  display_name: "Convex Migration Helper"
-  short_description: "Plan and run safe Convex schema and data migrations."
-  icon_small: "./assets/icon.svg"
-  icon_large: "./assets/icon.svg"
-  brand_color: "#8B5CF6"
-  default_prompt: "Help me plan and execute this Convex migration safely. Start by identifying the schema change, the existing data shape, and the widen-migrate-narrow path before making edits."
+  display_name: 'Convex Migration Helper'
+  short_description: 'Plan and run safe Convex schema and data migrations.'
+  icon_small: './assets/icon.svg'
+  icon_large: './assets/icon.svg'
+  brand_color: '#8B5CF6'
+  default_prompt: 'Help me plan and execute this Convex migration safely. Start by identifying the schema change, the existing data shape, and the widen-migrate-narrow path before making edits.'
 
 policy:
   allow_implicit_invocation: true