superkit-mcp-server 1.0.2 → 1.1.0

package/skills/meta/file-todos/SKILL.md

@@ -1,88 +1,88 @@
----
-name: file-todos
-description: Manage file-based todo tracking in the todos/ directory
----
-
-# File-Based Todo Tracking
-
-Provides workflows for creating, managing, and completing todos stored as markdown files.
-
-## Overview
-
-The `todos/` directory contains markdown files with YAML frontmatter for tracking work items.
-
-## File Naming Convention
-
-```
-{issue_id}-{status}-{priority}-{description}.md
-
-Examples:
-001-pending-p1-security-fix.md
-002-ready-p2-performance-opt.md
-003-complete-p3-cleanup.md
-```
-
-## Status Lifecycle
-
-```
-pending → ready → complete
-   ↓
-(deleted if skipped)
-```
-
-## What do you want to do?
-
-1. **Create a todo** → See "Creating Todos" below
-2. **Triage pending items** → Use `/triage`
-3. **Work on todos** → Use `/resolve_todo`
-4. **Check dependencies** → See "Dependency Management" below
-
----
-
-## Instrumentation
-
-```bash
-# Log usage when using this skill
-./scripts/log-skill.sh "file-todos" "manual" "$$"
-```
-
-## Creating Todos
-
-```bash
-# Get next ID
-next_id=$(ls todos/*.md 2>/dev/null | grep -o '[0-9]\+' | sort -n | tail -1 | awk '{printf "%03d", $1+1}')
-[ -z "$next_id" ] && next_id="001"
-
-# Copy template
-cp todos/todo-template.md todos/${next_id}-pending-{priority}-{description}.md
-```
-
-## Dependency Management
-
-```yaml
-# In YAML frontmatter
-dependencies: ["001", "002"]  # Blocked by these issues
-dependencies: []               # No blockers
-```
-
-Check blockers:
-```bash
-grep "dependencies:" todos/{file}.md
-```
-
-## Quick Commands
-
-```bash
-# List by status
-ls todos/*-pending-*.md
-ls todos/*-ready-*.md
-ls todos/*-complete-*.md
-
-# List by priority
-ls todos/*-p1-*.md
-
-# Count by status
-for s in pending ready complete; do
-  echo "$s: $(ls todos/*-$s-*.md 2>/dev/null | wc -l)"
-done
-```
+---
+name: file-todos
+description: Manage file-based todo tracking in the todos/ directory
+---
+
+# File-Based Todo Tracking
+
+Provides workflows for creating, managing, and completing todos stored as markdown files.
+
+## Overview
+
+The `todos/` directory contains markdown files with YAML frontmatter for tracking work items.
+
+## File Naming Convention
+
+```
+{issue_id}-{status}-{priority}-{description}.md
+
+Examples:
+001-pending-p1-security-fix.md
+002-ready-p2-performance-opt.md
+003-complete-p3-cleanup.md
+```
+
+## Status Lifecycle
+
+```
+pending → ready → complete
+   ↓
+(deleted if skipped)
+```
+
+## What do you want to do?
+
+1. **Create a todo** → See "Creating Todos" below
+2. **Triage pending items** → Use `/triage`
+3. **Work on todos** → Use `/resolve_todo`
+4. **Check dependencies** → See "Dependency Management" below
+
+---
+
+## Instrumentation
+
+```bash
+# Log usage when using this skill
+./scripts/log-skill.sh "file-todos" "manual" "$$"
+```
+
+## Creating Todos
+
+```bash
+# Get next ID
+next_id=$(ls todos/*.md 2>/dev/null | grep -o '[0-9]\+' | sort -n | tail -1 | awk '{printf "%03d", $1+1}')
+[ -z "$next_id" ] && next_id="001"
+
+# Copy template
+cp todos/todo-template.md todos/${next_id}-pending-{priority}-{description}.md
+```
+
+## Dependency Management
+
+```yaml
+# In YAML frontmatter
+dependencies: ["001", "002"]  # Blocked by these issues
+dependencies: []               # No blockers
+```
+
+Check blockers:
+```bash
+grep "dependencies:" todos/{file}.md
+```
+
+## Quick Commands
+
+```bash
+# List by status
+ls todos/*-pending-*.md
+ls todos/*-ready-*.md
+ls todos/*-complete-*.md
+
+# List by priority
+ls todos/*-p1-*.md
+
+# Count by status
+for s in pending ready complete; do
+  echo "$s: $(ls todos/*-$s-*.md 2>/dev/null | wc -l)"
+done
+```

package/skills/meta/mobile/SKILL.md

@@ -1,140 +1,140 @@
-# Mobile Development Skill
-
-## Overview
-React Native, Flutter, and mobile development best practices.
-
-## React Native Patterns
-
-### 1. Project Structure
-```
-src/
-├── components/       # Reusable UI components
-│   ├── Button.tsx
-│   └── Card.tsx
-├── screens/          # Screen components
-│   ├── Home.tsx
-│   └── Profile.tsx
-├── navigation/       # Navigation config
-│   └── AppNavigator.tsx
-├── hooks/            # Custom hooks
-├── services/         # API calls
-├── stores/           # State management
-└── utils/            # Utilities
-```
-
-### 2. Navigation
-```tsx
-import { NavigationContainer } from '@react-navigation/native';
-import { createNativeStackNavigator } from '@react-navigation/native-stack';
-
-const Stack = createNativeStackNavigator();
-
-function AppNavigator() {
-  return (
-    <NavigationContainer>
-      <Stack.Navigator initialRouteName="Home">
-        <Stack.Screen name="Home" component={HomeScreen} />
-        <Stack.Screen name="Profile" component={ProfileScreen} />
-      </Stack.Navigator>
-    </NavigationContainer>
-  );
-}
-```
-
-### 3. Styling
-```tsx
-import { StyleSheet, View, Text } from 'react-native';
-
-const styles = StyleSheet.create({
-  container: {
-    flex: 1,
-    padding: 16,
-    backgroundColor: '#fff',
-  },
-  title: {
-    fontSize: 24,
-    fontWeight: 'bold',
-    marginBottom: 12,
-  },
-});
-
-// Or use styled-components
-import styled from 'styled-components/native';
-
-const Container = styled.View`
-  flex: 1;
-  padding: 16px;
-`;
-```
-
-## Performance Optimization
-
-### FlatList Best Practices
-```tsx
-<FlatList
-  data={items}
-  renderItem={({ item }) => <ItemCard item={item} />}
-  keyExtractor={(item) => item.id}
-  
-  // Performance props
-  removeClippedSubviews={true}
-  maxToRenderPerBatch={10}
-  windowSize={5}
-  initialNumToRender={10}
-  getItemLayout={(data, index) => ({
-    length: ITEM_HEIGHT,
-    offset: ITEM_HEIGHT * index,
-    index,
-  })}
-/>
-```
-
-### Memoization
-```tsx
-// Memoize expensive components
-const MemoizedItem = React.memo(({ item }) => (
-  <View>
-    <Text>{item.title}</Text>
-  </View>
-));
-
-// useCallback for event handlers
-const handlePress = useCallback(() => {
-  navigation.navigate('Details', { id: item.id });
-}, [item.id]);
-```
-
-## Platform-Specific Code
-```tsx
-import { Platform } from 'react-native';
-
-const styles = StyleSheet.create({
-  shadow: Platform.select({
-    ios: {
-      shadowColor: '#000',
-      shadowOffset: { width: 0, height: 2 },
-      shadowOpacity: 0.25,
-    },
-    android: {
-      elevation: 5,
-    },
-  }),
-});
-
-// Or use file extensions
-// Button.ios.tsx
-// Button.android.tsx
-```
-
-## Testing
-```typescript
-import { render, fireEvent } from '@testing-library/react-native';
-
-test('button press', () => {
-  const onPress = jest.fn();
-  const { getByText } = render(<Button onPress={onPress} title="Click" />);
-  
-  fireEvent.press(getByText('Click'));
-  expect(onPress).toHaveBeenCalled();
-});
-```
+# Mobile Development Skill
+
+## Overview
+React Native, Flutter, and mobile development best practices.
+
+## React Native Patterns
+
+### 1. Project Structure
+```
+src/
+├── components/       # Reusable UI components
+│   ├── Button.tsx
+│   └── Card.tsx
+├── screens/          # Screen components
+│   ├── Home.tsx
+│   └── Profile.tsx
+├── navigation/       # Navigation config
+│   └── AppNavigator.tsx
+├── hooks/            # Custom hooks
+├── services/         # API calls
+├── stores/           # State management
+└── utils/            # Utilities
+```
+
+### 2. Navigation
+```tsx
+import { NavigationContainer } from '@react-navigation/native';
+import { createNativeStackNavigator } from '@react-navigation/native-stack';
+
+const Stack = createNativeStackNavigator();
+
+function AppNavigator() {
+  return (
+    <NavigationContainer>
+      <Stack.Navigator initialRouteName="Home">
+        <Stack.Screen name="Home" component={HomeScreen} />
+        <Stack.Screen name="Profile" component={ProfileScreen} />
+      </Stack.Navigator>
+    </NavigationContainer>
+  );
+}
+```
+
+### 3. Styling
+```tsx
+import { StyleSheet, View, Text } from 'react-native';
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    padding: 16,
+    backgroundColor: '#fff',
+  },
+  title: {
+    fontSize: 24,
+    fontWeight: 'bold',
+    marginBottom: 12,
+  },
+});
+
+// Or use styled-components
+import styled from 'styled-components/native';
+
+const Container = styled.View`
+  flex: 1;
+  padding: 16px;
+`;
+```
+
+## Performance Optimization
+
+### FlatList Best Practices
+```tsx
+<FlatList
+  data={items}
+  renderItem={({ item }) => <ItemCard item={item} />}
+  keyExtractor={(item) => item.id}
+  
+  // Performance props
+  removeClippedSubviews={true}
+  maxToRenderPerBatch={10}
+  windowSize={5}
+  initialNumToRender={10}
+  getItemLayout={(data, index) => ({
+    length: ITEM_HEIGHT,
+    offset: ITEM_HEIGHT * index,
+    index,
+  })}
+/>
+```
+
+### Memoization
+```tsx
+// Memoize expensive components
+const MemoizedItem = React.memo(({ item }) => (
+  <View>
+    <Text>{item.title}</Text>
+  </View>
+));
+
+// useCallback for event handlers
+const handlePress = useCallback(() => {
+  navigation.navigate('Details', { id: item.id });
+}, [item.id]);
+```
+
+## Platform-Specific Code
+```tsx
+import { Platform } from 'react-native';
+
+const styles = StyleSheet.create({
+  shadow: Platform.select({
+    ios: {
+      shadowColor: '#000',
+      shadowOffset: { width: 0, height: 2 },
+      shadowOpacity: 0.25,
+    },
+    android: {
+      elevation: 5,
+    },
+  }),
+});
+
+// Or use file extensions
+// Button.ios.tsx
+// Button.android.tsx
+```
+
+## Testing
+```typescript
+import { render, fireEvent } from '@testing-library/react-native';
+
+test('button press', () => {
+  const onPress = jest.fn();
+  const { getByText } = render(<Button onPress={onPress} title="Click" />);
+  
+  fireEvent.press(getByText('Click'));
+  expect(onPress).toHaveBeenCalled();
+});
+```

package/skills/meta/nextjs/SKILL.md

@@ -1,101 +1,101 @@
-# Next.js Best Practices Skill
-
-## Overview
-Next.js App Router architecture, Server Components, and modern patterns.
-
-## Core Concepts
-
-### 1. App Router Structure
-```
-app/
-├── layout.tsx          # Root layout
-├── page.tsx            # Home page
-├── loading.tsx         # Loading UI
-├── error.tsx           # Error UI
-├── not-found.tsx       # 404 page
-├── (marketing)/        # Route group
-│   ├── about/
-│   └── contact/
-└── api/
-    └── route.ts        # API route
-```
-
-### 2. Server vs Client Components
-
-```tsx
-// Server Component (default)
-async function UserProfile({ userId }: { userId: string }) {
-  const user = await getUser(userId); // Direct DB access
-  return <div>{user.name}</div>;
-}
-
-// Client Component
-'use client';
-import { useState } from 'react';
-
-function Counter() {
-  const [count, setCount] = useState(0);
-  return <button onClick={() => setCount(c => c + 1)}>{count}</button>;
-}
-```
-
-### 3. Data Fetching
-```tsx
-// Server Component with fetch
-async function Posts() {
-  const posts = await fetch('https://api.example.com/posts', {
-    next: { revalidate: 3600 } // ISR: revalidate every hour
-  }).then(res => res.json());
-  
-  return posts.map(post => <PostCard key={post.id} post={post} />);
-}
-
-// Server Actions
-'use server';
-async function createPost(formData: FormData) {
-  const title = formData.get('title');
-  await db.posts.create({ title });
-  revalidatePath('/posts');
-}
-```
-
-### 4. Metadata & SEO
-```tsx
-export const metadata: Metadata = {
-  title: 'My App',
-  description: 'App description',
-  openGraph: {
-    title: 'My App',
-    images: ['/og-image.png'],
-  },
-};
-
-// Dynamic metadata
-export async function generateMetadata({ params }): Promise<Metadata> {
-  const post = await getPost(params.id);
-  return { title: post.title };
-}
-```
-
-### 5. Route Handlers (API)
-```tsx
-// app/api/users/route.ts
-import { NextResponse } from 'next/server';
-
-export async function GET(request: Request) {
-  const users = await getUsers();
-  return NextResponse.json(users);
-}
-
-export async function POST(request: Request) {
-  const body = await request.json();
-  const user = await createUser(body);
-  return NextResponse.json(user, { status: 201 });
-}
-```
-
-## Performance Tips
-- Use `<Image>` for automatic optimization
-- Leverage Streaming with `<Suspense>`
-- Use `next/dynamic` for conditional imports
-- Enable PPR (Partial Prerendering) where applicable
+# Next.js Best Practices Skill
+
+## Overview
+Next.js App Router architecture, Server Components, and modern patterns.
+
+## Core Concepts
+
+### 1. App Router Structure
+```
+app/
+├── layout.tsx          # Root layout
+├── page.tsx            # Home page
+├── loading.tsx         # Loading UI
+├── error.tsx           # Error UI
+├── not-found.tsx       # 404 page
+├── (marketing)/        # Route group
+│   ├── about/
+│   └── contact/
+└── api/
+    └── route.ts        # API route
+```
+
+### 2. Server vs Client Components
+
+```tsx
+// Server Component (default)
+async function UserProfile({ userId }: { userId: string }) {
+  const user = await getUser(userId); // Direct DB access
+  return <div>{user.name}</div>;
+}
+
+// Client Component
+'use client';
+import { useState } from 'react';
+
+function Counter() {
+  const [count, setCount] = useState(0);
+  return <button onClick={() => setCount(c => c + 1)}>{count}</button>;
+}
+```
+
+### 3. Data Fetching
+```tsx
+// Server Component with fetch
+async function Posts() {
+  const posts = await fetch('https://api.example.com/posts', {
+    next: { revalidate: 3600 } // ISR: revalidate every hour
+  }).then(res => res.json());
+  
+  return posts.map(post => <PostCard key={post.id} post={post} />);
+}
+
+// Server Actions
+'use server';
+async function createPost(formData: FormData) {
+  const title = formData.get('title');
+  await db.posts.create({ title });
+  revalidatePath('/posts');
+}
+```
+
+### 4. Metadata & SEO
+```tsx
+export const metadata: Metadata = {
+  title: 'My App',
+  description: 'App description',
+  openGraph: {
+    title: 'My App',
+    images: ['/og-image.png'],
+  },
+};
+
+// Dynamic metadata
+export async function generateMetadata({ params }): Promise<Metadata> {
+  const post = await getPost(params.id);
+  return { title: post.title };
+}
+```
+
+### 5. Route Handlers (API)
+```tsx
+// app/api/users/route.ts
+import { NextResponse } from 'next/server';
+
+export async function GET(request: Request) {
+  const users = await getUsers();
+  return NextResponse.json(users);
+}
+
+export async function POST(request: Request) {
+  const body = await request.json();
+  const user = await createUser(body);
+  return NextResponse.json(user, { status: 201 });
+}
+```
+
+## Performance Tips
+- Use `<Image>` for automatic optimization
+- Leverage Streaming with `<Suspense>`
+- Use `next/dynamic` for conditional imports
+- Enable PPR (Partial Prerendering) where applicable