npm - @musashishao/agent-kit - Versions diffs - 1.8.2 → 1.9.1 - Mend

@musashishao/agent-kit 1.8.2 → 1.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (176) hide show

package/.agent/agents/ai-architect.md +39 -0
package/.agent/agents/ai-asset-factory.md +700 -0
package/.agent/agents/ai-audio-factory.md +503 -0
package/.agent/agents/cloud-engineer.md +39 -0
package/.agent/agents/game-developer.md +190 -89
package/.agent/agents/marketing-specialist.md +41 -0
package/.agent/agents/orchestrator.md +113 -3
package/.agent/agents/penetration-tester.md +15 -1
package/.agent/agents/project-planner.md +67 -0
package/.agent/agents/unity-mobile-master.md +949 -0
package/.agent/mcp/config/registry.json +65 -51
package/.agent/mcp/servers/notebooklm/README.md +114 -0
package/.agent/mcp/servers/notebooklm/package.json +35 -0
package/.agent/mcp/servers/notebooklm/src/auth/chrome.ts +225 -0
package/.agent/mcp/servers/notebooklm/src/auth/index.ts +1 -0
package/.agent/mcp/servers/notebooklm/src/index.ts +516 -0
package/.agent/mcp/servers/notebooklm/src/services/index.ts +3 -0
package/.agent/mcp/servers/notebooklm/src/services/library.ts +217 -0
package/.agent/mcp/servers/notebooklm/src/services/notebooklm.ts +380 -0
package/.agent/mcp/servers/notebooklm/tsconfig.json +15 -0
package/.agent/mcp-gateway/README.md +169 -20
package/.agent/mcp-gateway/package.json +22 -7
package/.agent/mcp-gateway/src/auth/index.ts +55 -0
package/.agent/mcp-gateway/src/auth/middleware.ts +242 -0
package/.agent/mcp-gateway/src/auth/oauth.ts +462 -0
package/.agent/mcp-gateway/src/auth/scopes.ts +227 -0
package/.agent/mcp-gateway/src/index.ts +252 -105
package/.agent/mcp-gateway/src/observability/index.ts +5 -0
package/.agent/mcp-gateway/src/observability/otel.ts +405 -0
package/.agent/mcp-gateway/src/transports/index.ts +5 -0
package/.agent/mcp-gateway/src/transports/streamableHttp.ts +235 -0
package/.agent/rules/CODEX.md +115 -2
package/.agent/rules/CODE_RULES.md +73 -0
package/.agent/rules/GEMINI.md +26 -1
package/.agent/rules/MEMORY_STATE.md +110 -0
package/.agent/rules/REFERENCE.md +40 -58
package/.agent/rules/REF_SKILLS.md +116 -0
package/.agent/rules/REF_WORKFLOWS.md +81 -0
package/.agent/scripts/ak_cli.py +106 -5
package/.agent/scripts/memory_manager.py +48 -9
package/.agent/skills/3d-web-experience/SKILL.md +386 -0
package/.agent/skills/DEPENDENCIES.md +54 -0
package/.agent/skills/ab-test-setup/SKILL.md +77 -0
package/.agent/skills/active-directory-attacks/SKILL.md +59 -0
package/.agent/skills/agent-evaluation/SKILL.md +430 -0
package/.agent/skills/agent-memory-systems/SKILL.md +426 -0
package/.agent/skills/agent-tool-builder/SKILL.md +139 -0
package/.agent/skills/ai-agents-architect/SKILL.md +115 -0
package/.agent/skills/ai-product/SKILL.md +86 -0
package/.agent/skills/ai-wrapper-product/SKILL.md +90 -0
package/.agent/skills/analytics-tracking/SKILL.md +88 -0
package/.agent/skills/anti-hallucination/SKILL.md +295 -0
package/.agent/skills/anti-hallucination/scripts/check_hallucination.py +299 -0
package/.agent/skills/api-fuzzing-bug-bounty/SKILL.md +66 -0
package/.agent/skills/app-store-optimization/SKILL.md +66 -0
package/.agent/skills/autonomous-agent-patterns/SKILL.md +414 -0
package/.agent/skills/aws-penetration-testing/SKILL.md +50 -0
package/.agent/skills/aws-serverless/SKILL.md +327 -0
package/.agent/skills/azure-functions/SKILL.md +340 -0
package/.agent/skills/bifurcation-analysis/SKILL.md +56 -0
package/.agent/skills/brainstorming/SKILL.md +80 -6
package/.agent/skills/broken-authentication/SKILL.md +53 -0
package/.agent/skills/browser-automation/SKILL.md +408 -0
package/.agent/skills/browser-extension-builder/SKILL.md +422 -0
package/.agent/skills/bullmq-specialist/SKILL.md +424 -0
package/.agent/skills/bun-development/SKILL.md +386 -0
package/.agent/skills/burp-suite-testing/SKILL.md +60 -0
package/.agent/skills/clerk-auth/SKILL.md +432 -0
package/.agent/skills/cloud-penetration-testing/SKILL.md +51 -0
package/.agent/skills/copywriting/SKILL.md +66 -0
package/.agent/skills/crewai/SKILL.md +470 -0
package/.agent/skills/decision-memory/SKILL.md +317 -0
package/.agent/skills/discord-bot-architect/SKILL.md +447 -0
package/.agent/skills/email-sequence/SKILL.md +73 -0
package/.agent/skills/emergence-detector/SKILL.md +230 -0
package/.agent/skills/emergence-detector/scripts/check_emergence.py +265 -0
package/.agent/skills/ethical-hacking-methodology/SKILL.md +67 -0
package/.agent/skills/explained-qa/SKILL.md +142 -0
package/.agent/skills/explained-qa/game-terminology.md +214 -0
package/.agent/skills/firebase/SKILL.md +377 -0
package/.agent/skills/game-development/ai-dialogue-engine/SKILL.md +442 -0
package/.agent/skills/game-development/ai-graphics-generator/SKILL.md +463 -0
package/.agent/skills/game-development/ai-playtest-framework/SKILL.md +570 -0
package/.agent/skills/game-development/camera-systems/SKILL.md +607 -0
package/.agent/skills/game-development/card-battle-engine/SKILL.md +618 -0
package/.agent/skills/game-development/character-controller-3d/SKILL.md +908 -0
package/.agent/skills/game-development/cloud-save-sync/SKILL.md +527 -0
package/.agent/skills/game-development/combat-system/SKILL.md +748 -0
package/.agent/skills/game-development/compliance-rating/SKILL.md +277 -0
package/.agent/skills/game-development/crossplatform-build/SKILL.md +386 -0
package/.agent/skills/game-development/cultivation-progression/SKILL.md +520 -0
package/.agent/skills/game-development/data-driven-balance/SKILL.md +535 -0
package/.agent/skills/game-development/game-analytics-integrator/SKILL.md +410 -0
package/.agent/skills/game-development/game-audio-advanced/SKILL.md +646 -0
package/.agent/skills/game-development/game-economy-designer/SKILL.md +375 -0
package/.agent/skills/game-development/game-marketing/SKILL.md +85 -0
package/.agent/skills/game-development/game-state-manager/SKILL.md +883 -0
package/.agent/skills/game-development/godot-expert/SKILL.md +462 -0
package/.agent/skills/game-development/hybrid-game-spec/SKILL.md +220 -0
package/.agent/skills/game-development/inventory-quest/SKILL.md +747 -0
package/.agent/skills/game-development/liveops/SKILL.md +308 -0
package/.agent/skills/game-development/localization/SKILL.md +286 -0
package/.agent/skills/game-development/mobile-input-patterns/SKILL.md +343 -0
package/.agent/skills/game-development/monetization-strategy/SKILL.md +94 -0
package/.agent/skills/game-development/multiplayer-master/SKILL.md +727 -0
package/.agent/skills/game-development/narrative-branching/SKILL.md +593 -0
package/.agent/skills/game-development/npc-ai-integration/SKILL.md +110 -0
package/.agent/skills/game-development/procedural-generation/SKILL.md +168 -0
package/.agent/skills/game-development/procedural-level-ai/SKILL.md +367 -0
package/.agent/skills/game-development/prototyping-rapid/SKILL.md +205 -0
package/.agent/skills/game-development/spec-ecosystem/SKILL.md +155 -0
package/.agent/skills/game-development/spec-ecosystem/decision-log-format.md +129 -0
package/.agent/skills/game-development/spec-ecosystem/templates/PLAN-template.md +178 -0
package/.agent/skills/game-development/spec-ecosystem/templates/SPEC-template.md +110 -0
package/.agent/skills/game-development/spec-ecosystem/templates/TASKS-template.md +156 -0
package/.agent/skills/game-development/survival-systems/SKILL.md +493 -0
package/.agent/skills/game-development/testing-qa/SKILL.md +270 -0
package/.agent/skills/game-development/unity-integration/SKILL.md +358 -0
package/.agent/skills/game-development/unity-mobile-optimization/SKILL.md +271 -0
package/.agent/skills/game-development/webgpu-shading/SKILL.md +209 -0
package/.agent/skills/gcp-cloud-run/SKILL.md +358 -0
package/.agent/skills/graphql/SKILL.md +492 -0
package/.agent/skills/idor-testing/SKILL.md +64 -0
package/.agent/skills/inngest/SKILL.md +128 -0
package/.agent/skills/intent-capture/SKILL.md +65 -0
package/.agent/skills/langfuse/SKILL.md +415 -0
package/.agent/skills/langgraph/SKILL.md +360 -0
package/.agent/skills/launch-strategy/SKILL.md +68 -0
package/.agent/skills/linux-privilege-escalation/SKILL.md +62 -0
package/.agent/skills/llm-app-patterns/SKILL.md +367 -0
package/.agent/skills/marketing-ideas/SKILL.md +66 -0
package/.agent/skills/mcp-composition/SKILL.md +362 -0
package/.agent/skills/mcp-observability/SKILL.md +323 -0
package/.agent/skills/mcp-security/SKILL.md +314 -0
package/.agent/skills/metasploit-framework/SKILL.md +60 -0
package/.agent/skills/micro-saas-launcher/SKILL.md +93 -0
package/.agent/skills/neon-postgres/SKILL.md +339 -0
package/.agent/skills/paid-ads/SKILL.md +64 -0
package/.agent/skills/supabase-integration/SKILL.md +411 -0
package/.agent/skills/trust-spectrum/SKILL.md +291 -0
package/.agent/skills/vibe-coding-guard/SKILL.md +328 -0
package/.agent/templates/AGENTS.game.md +63 -0
package/.agent/templates/docs/WORKFLOW_GUIDE.en.md +100 -0
package/.agent/templates/docs/WORKFLOW_GUIDE.vi.md +100 -0
package/.agent/workflows/ai-agent.md +38 -0
package/.agent/workflows/autofix.md +1 -0
package/.agent/workflows/brainstorm.md +1 -0
package/.agent/workflows/context.md +1 -0
package/.agent/workflows/create.md +39 -8
package/.agent/workflows/dashboard.md +1 -0
package/.agent/workflows/debug.md +14 -0
package/.agent/workflows/deploy.md +14 -0
package/.agent/workflows/enhance.md +44 -0
package/.agent/workflows/gamekit-init.md +177 -0
package/.agent/workflows/gamekit-launch.md +338 -0
package/.agent/workflows/gamekit-plan.md +204 -0
package/.agent/workflows/gamekit-qa.md +153 -0
package/.agent/workflows/gamekit-spec.md +243 -0
package/.agent/workflows/gamekit-tasks.md +208 -0
package/.agent/workflows/marketing.md +39 -0
package/.agent/workflows/next.md +1 -0
package/.agent/workflows/orchestrate.md +12 -0
package/.agent/workflows/pentest.md +39 -0
package/.agent/workflows/plan.md +42 -0
package/.agent/workflows/preview.md +1 -0
package/.agent/workflows/quality.md +1 -0
package/.agent/workflows/saas.md +38 -0
package/.agent/workflows/spec.md +42 -0
package/.agent/workflows/status.md +1 -0
package/.agent/workflows/test.md +14 -0
package/.agent/workflows/ui-ux-pro-max.md +1 -0
package/README.md +4 -4
package/bin/cli.js +411 -111
package/package.json +1 -2
package/docs/AI_DATA_INFRASTRUCTURE.md +0 -288
package/docs/CHANGELOG_AI_INFRA.md +0 -111

package/.agent/skills/clerk-auth/SKILL.md ADDED Viewed

@@ -0,0 +1,432 @@
+---
+name: clerk-auth
+description: "Clerk authentication integration for Next.js. Modern auth with pre-built components, organizations, MFA, and seamless user management."
+version: "1.0.0"
+---
+# 🔐 Clerk Auth
+You are a Clerk authentication expert. Clerk provides drop-in auth components, user management, organizations, and session handling that works seamlessly with Next.js App Router.
+---
+## When to Use This Skill
+- Need quick, polished auth UI
+- Organization/team management required
+- Multi-factor authentication needed
+- Want managed user profiles
+- Need webhooks for user events
+---
+## Capabilities
+- `clerk-auth`
+- `clerk-organizations`
+- `clerk-webhooks`
+- `clerk-middleware`
+- `clerk-components`
+---
+## 1. Setup
+```bash
+npm install @clerk/nextjs
+```
+### Environment Variables
+```env
+NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
+CLERK_SECRET_KEY=sk_test_...
+NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
+NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
+NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/dashboard
+NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/dashboard
+```
+### Provider Setup
+```typescript
+// app/layout.tsx
+import { ClerkProvider } from '@clerk/nextjs'
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <ClerkProvider>
+      <html lang="en">
+        <body>{children}</body>
+      </html>
+    </ClerkProvider>
+  )
+}
+```
+---
+## 2. Middleware
+```typescript
+// middleware.ts
+import { clerkMiddleware, createRouteMatcher } from '@clerk/nextjs/server'
+const isPublicRoute = createRouteMatcher([
+  '/',
+  '/sign-in(.*)',
+  '/sign-up(.*)',
+  '/api/webhooks(.*)',
+])
+const isProtectedRoute = createRouteMatcher([
+  '/dashboard(.*)',
+  '/settings(.*)',
+  '/api/protected(.*)',
+])
+export default clerkMiddleware(async (auth, request) => {
+  if (isProtectedRoute(request)) {
+    await auth.protect()
+  }
+})
+export const config = {
+  matcher: ['/((?!.*\\..*|_next).*)', '/', '/(api|trpc)(.*)'],
+}
+```
+---
+## 3. Pre-built Components
+### Sign In/Up Pages
+```typescript
+// app/sign-in/[[...sign-in]]/page.tsx
+import { SignIn } from '@clerk/nextjs'
+export default function SignInPage() {
+  return (
+    <div className="flex min-h-screen items-center justify-center">
+      <SignIn
+        appearance={{
+          elements: {
+            formButtonPrimary: 'bg-primary hover:bg-primary/90',
+            footerActionLink: 'text-primary hover:text-primary/90',
+          }
+        }}
+      />
+    </div>
+  )
+}
+// app/sign-up/[[...sign-up]]/page.tsx
+import { SignUp } from '@clerk/nextjs'
+export default function SignUpPage() {
+  return (
+    <div className="flex min-h-screen items-center justify-center">
+      <SignUp />
+    </div>
+  )
+}
+```
+### User Button
+```typescript
+// components/navbar.tsx
+import { SignedIn, SignedOut, UserButton, SignInButton } from '@clerk/nextjs'
+export function Navbar() {
+  return (
+    <nav className="flex items-center justify-between p-4">
+      <Logo />
+      <SignedIn>
+        <UserButton
+          afterSignOutUrl="/"
+          appearance={{
+            elements: {
+              avatarBox: 'h-10 w-10'
+            }
+          }}
+        />
+      </SignedIn>
+      <SignedOut>
+        <SignInButton mode="modal">
+          <button className="btn btn-primary">Sign In</button>
+        </SignInButton>
+      </SignedOut>
+    </nav>
+  )
+}
+```
+---
+## 4. Server-Side Auth
+### In Server Components
+```typescript
+// app/dashboard/page.tsx
+import { auth, currentUser } from '@clerk/nextjs/server'
+import { redirect } from 'next/navigation'
+export default async function DashboardPage() {
+  const { userId } = await auth()
+  if (!userId) {
+    redirect('/sign-in')
+  }
+  const user = await currentUser()
+  return (
+    <div>
+      <h1>Welcome, {user?.firstName}!</h1>
+      <p>Email: {user?.emailAddresses[0]?.emailAddress}</p>
+    </div>
+  )
+}
+```
+### In Server Actions
+```typescript
+// app/actions.ts
+'use server'
+import { auth } from '@clerk/nextjs/server'
+import { prisma } from '@/lib/prisma'
+export async function createPost(data: { title: string; content: string }) {
+  const { userId } = await auth()
+  if (!userId) {
+    throw new Error('Unauthorized')
+  }
+  return prisma.post.create({
+    data: {
+      ...data,
+      authorId: userId,
+    }
+  })
+}
+```
+### In API Routes
+```typescript
+// app/api/protected/route.ts
+import { auth } from '@clerk/nextjs/server'
+import { NextResponse } from 'next/server'
+export async function GET() {
+  const { userId } = await auth()
+  if (!userId) {
+    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
+  }
+  // Fetch user-specific data
+  const data = await getUserData(userId)
+  return NextResponse.json(data)
+}
+```
+---
+## 5. Client-Side Auth
+```typescript
+'use client'
+import { useAuth, useUser } from '@clerk/nextjs'
+export function ProfileCard() {
+  const { isLoaded, isSignedIn, user } = useUser()
+  const { signOut, getToken } = useAuth()
+  if (!isLoaded) {
+    return <div>Loading...</div>
+  }
+  if (!isSignedIn) {
+    return <div>Please sign in</div>
+  }
+  const handleApiCall = async () => {
+    // Get JWT for API calls
+    const token = await getToken()
+    const response = await fetch('/api/protected', {
+      headers: {
+        Authorization: `Bearer ${token}`
+      }
+    })
+    // ...
+  }
+  return (
+    <div>
+      <img src={user.imageUrl} alt={user.fullName ?? ''} />
+      <h2>{user.fullName}</h2>
+      <p>{user.primaryEmailAddress?.emailAddress}</p>
+      <button onClick={() => signOut()}>Sign Out</button>
+    </div>
+  )
+}
+```
+---
+## 6. Organizations (Teams)
+```typescript
+// Enable organizations in Clerk Dashboard first
+// app/org/page.tsx
+import { OrganizationSwitcher, OrganizationList } from '@clerk/nextjs'
+export default function OrganizationPage() {
+  return (
+    <div>
+      <h1>Organizations</h1>
+      {/* Switch between orgs */}
+      <OrganizationSwitcher />
+      {/* List all orgs */}
+      <OrganizationList
+        afterSelectOrganizationUrl="/dashboard"
+        afterCreateOrganizationUrl="/dashboard"
+      />
+    </div>
+  )
+}
+// Check org membership in server
+import { auth } from '@clerk/nextjs/server'
+export async function checkOrgAccess() {
+  const { orgId, orgRole } = await auth()
+  if (!orgId) {
+    throw new Error('No organization selected')
+  }
+  if (orgRole !== 'org:admin') {
+    throw new Error('Admin access required')
+  }
+  return { orgId, orgRole }
+}
+```
+---
+## 7. Webhooks
+```typescript
+// app/api/webhooks/clerk/route.ts
+import { Webhook } from 'svix'
+import { headers } from 'next/headers'
+import { WebhookEvent } from '@clerk/nextjs/server'
+export async function POST(req: Request) {
+  const WEBHOOK_SECRET = process.env.CLERK_WEBHOOK_SECRET!
+  const headersList = await headers()
+  const svix_id = headersList.get('svix-id')
+  const svix_timestamp = headersList.get('svix-timestamp')
+  const svix_signature = headersList.get('svix-signature')
+  if (!svix_id || !svix_timestamp || !svix_signature) {
+    return new Response('Missing svix headers', { status: 400 })
+  }
+  const payload = await req.json()
+  const body = JSON.stringify(payload)
+  const wh = new Webhook(WEBHOOK_SECRET)
+  let evt: WebhookEvent
+  try {
+    evt = wh.verify(body, {
+      'svix-id': svix_id,
+      'svix-timestamp': svix_timestamp,
+      'svix-signature': svix_signature,
+    }) as WebhookEvent
+  } catch (err) {
+    return new Response('Invalid signature', { status: 400 })
+  }
+  // Handle the webhook
+  switch (evt.type) {
+    case 'user.created':
+      await createUserInDatabase(evt.data)
+      break
+    case 'user.updated':
+      await updateUserInDatabase(evt.data)
+      break
+    case 'user.deleted':
+      await deleteUserFromDatabase(evt.data.id!)
+      break
+  }
+  return new Response('OK', { status: 200 })
+}
+```
+---
+## 8. Anti-Patterns
+### ❌ Checking Auth in Layout Only
+```typescript
+// WRONG: Auth check in layout, not in pages
+// app/dashboard/layout.tsx
+export default async function Layout({ children }) {
+  const { userId } = await auth()
+  if (!userId) redirect('/sign-in')
+  return children
+}
+// User can still access nested routes via direct URL!
+// CORRECT: Use middleware for route protection
+// middleware.ts
+export default clerkMiddleware(...)
+```
+### ❌ Storing User Data Only in Clerk
+```typescript
+// WRONG: Relying only on Clerk for user data
+const user = await currentUser()
+const subscription = user?.publicMetadata?.subscription // Limited storage!
+// CORRECT: Sync to your database
+const dbUser = await prisma.user.findUnique({
+  where: { clerkId: userId }
+})
+```
+---
+## Related Skills
+- `nextjs-best-practices` - Next.js patterns
+- `api-patterns` - Auth in APIs
+- `supabase-integration` - Alternative auth

package/.agent/skills/cloud-penetration-testing/SKILL.md ADDED Viewed

@@ -0,0 +1,51 @@
+---
+name: cloud-penetration-testing
+description: "General methodology for testing Cloud environments (Azure, GCP, O365). Covers shared responsibility, tenant isolation, and API security."
+version: "1.0.0"
+---
+# ☁️ Cloud Penetration Testing
+You are a versatile Cloud Auditor. You understand the shared responsibility model: the provider secures the cloud, you secure what's *in* the cloud. You test for isolation failures and service-specific misconfigurations.
+---
+## Azure Specifics
+- **Azure AD (Entra ID)**: Testing for guest user over-permissions.
+- **Storage Accounts**: Similar to S3, but uses SAS tokens.
+- **Key Vault**: Finding secrets that have "Read" access for too many users.
+- **Tool**: `MicroBurst`.
+---
+## GCP Specifics
+- **Service Accounts**: The primary target for privilege escalation.
+- **Cloud Storage**: Permissions like `allUsers:roles/storage.objectViewer`.
+- **Project Hierarchy**: Inherited permissions from Folder/Organization level.
+- **Tool**: `GCPBucketBrute`.
+---
+## Common Cloud Vulnerabilities
+| Vulnerability | Impact | Mitigation |
+|---------------|--------|------------|
+| **SSRF** | Credentials theft via Metadata service | Use IMDSv2 (Session-based) |
+| **Insecure Secrets** | Database/API hard-coded in functions | Use Secret Manager / Key Vault |
+| **Public Snapshots** | Data leak from disk backups | Encrypt with KMS and disable public access |
+| **Excessive Permissions**| Full compromise of the cloud tenant | Follow Principle of Least Privilege (PoLP) |
+---
+## Auditing Workflow
+1. **Unauthenticated**: Bucket hunting, subdomain enumeration, login portals.
+2. **Authenticated**: Run `Cloudsploit` or `Prowler` for automatic configuration audit.
+3. **Manual**: Deep dive into IAM policies and trust relationships.
+---
+## Related Skills
+- `aws-penetration-testing` - AWS specific deep dive
+- `ethical-hacking-methodology` - General process
+- `vulnerability-scanner` - Automated tools

package/.agent/skills/copywriting/SKILL.md ADDED Viewed

@@ -0,0 +1,66 @@
+---
+name: copywriting
+description: "Expertise in persuasive writing for landing pages, ads, and emails. Covers headline formulas, value proposition design, and call-to-action optimization."
+version: "1.0.0"
+---
+# ✍️ Copywriting
+You are a high-conversion copywriter. You don't just write text; you design persuasion. You focus on user benefits, address objections, and guide readers toward a single desired action.
+---
+## When to Use This Skill
+- Writing landing page headlines and body text
+- Crafting high-CTR ad copy (Google, Meta, Twitter)
+- Writing subject lines and body for marketing emails
+- Designing value propositions for new products
+- Defining the "Voice of the Brand"
+---
+## Capabilities
+- `headline-formulas`
+- `value-prop-design`
+- `cta-optimization`
+- `storytelling-for-sales`
+- `objection-handling`
+---
+## 1. High-Performance Formulas
+| Formula | Implementation | Example |
+|---------|----------------|---------|
+| **PAS** | Problem - Agitation - Solution | "Hate manual data entry? It's killing your team's morale. Use OurApp to automate it instantly." |
+| **AIDA** | Attention - Interest - Desire - Action | "The fastest way to build apps is here. Trusted by 500 startups. Get started for free." |
+| **Benefit > Feature** | "Save 10 hours a week" instead of "Cloud-syncing folders" | Focus on what the user gets, not what the app does. |
+---
+## 2. Headline Engineering
+A great headline should do one of four things:
+1. **Self-Interest**: "Get 50% more leads."
+2. **Curiosity**: "The one tool every developer is hiding."
+3. **Quick & Easy**: "Build a landing page in 2 minutes."
+4. **News**: "The future of AI-native coding is here."
+---
+## 3. Objection Handling (The "FAQ" Pattern)
+Address the elephant in the room before the user asks:
+- *"Is it secure?"* -> Mention SOC2 or Encryption upfront.
+- *"Is it expensive?"* -> "Free forever for individuals."
+- *"Will it work for me?"* -> Testimonials from similar users.
+---
+## Related Skills
+- `frontend-design` - Layout matters for copy impact
+- `marketing-ideas` - Choosing the right angle
+- `email-sequence` - Applying copy to email flows