namnam-skills 1.0.0

package/src/templates/official-plugins/feature-dev.md

@@ -0,0 +1,65 @@
+# /feature-dev - Structured Feature Development
+
+7-phase structured feature development workflow with specialized agents.
+
+## Usage
+
+```
+/feature-dev implement user authentication
+/feature-dev add dark mode support
+/feature-dev create payment integration
+```
+
+## Instructions
+
+When the user invokes `/feature-dev`:
+
+### Phase 1: Discovery
+Use `code-explorer` agent to:
+- Understand current codebase structure
+- Identify relevant files and patterns
+- Map dependencies
+
+### Phase 2: Architecture
+Use `code-architect` agent to:
+- Design the feature architecture
+- Define interfaces and contracts
+- Plan file structure changes
+
+### Phase 3: Planning
+Create detailed implementation plan:
+- Break down into tasks
+- Identify potential blockers
+- Estimate complexity
+
+### Phase 4: Implementation
+Execute the plan:
+- Write code following existing patterns
+- Maintain consistency with codebase
+- Add appropriate error handling
+
+### Phase 5: Testing
+Write and run tests:
+- Unit tests for new functions
+- Integration tests for feature
+- Edge case coverage
+
+### Phase 6: Review
+Use `code-reviewer` agent to:
+- Check code quality
+- Verify architecture compliance
+- Identify potential issues
+
+### Phase 7: Documentation
+Update docs:
+- Add inline comments where needed
+- Update README if applicable
+- Document API changes
+
+## Agents Used
+
+| Agent | Purpose |
+|-------|---------|
+| `code-explorer` | Codebase discovery and mapping |
+| `code-architect` | Architecture design |
+| `code-reviewer` | Code quality review |

package/src/templates/official-plugins/frontend-design.md

@@ -0,0 +1,53 @@
+# Frontend Design
+
+Auto-invoked guidance for building distinctive, production-grade UI.
+
+## Usage
+
+This skill automatically activates when working on frontend code.
+
+## Focus Areas
+
+### Typography
+- Font pairing recommendations
+- Responsive typography scales
+- Line height and letter spacing
+- Hierarchy establishment
+
+### Motion & Animation
+- Micro-interactions
+- Page transitions
+- Loading states
+- Scroll animations
+- Performance-conscious animations
+
+### Visual Polish
+- Color theory application
+- Spacing consistency (8px grid)
+- Shadow and depth
+- Border radius patterns
+- Icon consistency
+
+### Production Quality
+- Cross-browser compatibility
+- Responsive breakpoints
+- Accessibility (WCAG 2.1)
+- Performance optimization
+- Dark mode support
+
+## Best Practices
+
+1. **Consistency** - Design tokens and CSS variables
+2. **Hierarchy** - Clear visual hierarchy
+3. **Whitespace** - Generous breathing room
+4. **Feedback** - Interactive state feedback
+5. **Polish** - Attention to detail
+
+## Output
+
+- Component suggestions
+- Style improvements
+- Animation recommendations
+- Accessibility fixes
+
+$ARGUMENTS

package/src/templates/official-plugins/hookify.md

@@ -0,0 +1,52 @@
+# Hookify
+
+Build custom hooks to prevent unwanted behavior and enforce coding standards.
+
+## Commands
+
+### /hookify
+Create a new hook interactively.
+
+### /hookify:list
+List all configured hooks.
+
+### /hookify:configure
+Edit hook configurations.
+
+### /hookify:help
+Show hook documentation.
+
+## Usage
+
+```
+/hookify create pre-commit linting check
+/hookify:list
+/hookify:configure my-hook
+```
+
+## Hook Types
+
+1. **PreToolUse** - Run before tool execution
+2. **PostToolUse** - Run after tool execution
+3. **SessionStart** - Run when session begins
+4. **SessionEnd** - Run when session ends
+5. **Stop** - Intercept exit attempts
+
+## Example Hook
+
+```yaml
+name: no-console-log
+trigger: PreToolUse
+pattern: "console.log"
+action: warn
+message: "Consider using a proper logger instead of console.log"
+```
+
+## Features
+
+- **conversation-analyzer** agent for pattern detection
+- **writing-rules** skill for rule syntax
+- Custom action handlers
+- Pattern matching with regex support
+
+$ARGUMENTS

package/src/templates/official-plugins/new-sdk-app.md

@@ -0,0 +1,45 @@
+# /new-sdk-app - Agent SDK Bootstrapper
+
+Create new Agent SDK applications with best practices.
+
+## Usage
+
+```
+/new-sdk-app python my-agent
+/new-sdk-app typescript my-agent
+```
+
+## Instructions
+
+When the user invokes `/new-sdk-app`:
+
+1. **Detect language**: Python or TypeScript
+2. **Create project structure**:
+   - For Python: Create virtual env, requirements.txt, main agent file
+   - For TypeScript: Create package.json, tsconfig.json, src/index.ts
+
+3. **Setup Agent SDK**:
+   ```python
+   # Python
+   from anthropic import Anthropic
+   from anthropic.types.beta import BetaMessage
+
+   client = Anthropic()
+   ```
+
+   ```typescript
+   // TypeScript
+   import Anthropic from '@anthropic-ai/sdk';
+
+   const client = new Anthropic();
+   ```
+
+4. **Include best practices**:
+   - Proper error handling
+   - Type safety
+   - Environment variable management
+   - Logging setup
+
+5. **Validate with agents**:
+   - Use `agent-sdk-verifier-py` for Python projects
+   - Use `agent-sdk-verifier-ts` for TypeScript projects

package/src/templates/official-plugins/plugin-dev.md

@@ -0,0 +1,53 @@
+# Plugin Development
+
+Eight-phase workflow for creating Claude Code plugins.
+
+## Usage
+
+```
+/plugin-dev:create-plugin <plugin-name>
+```
+
+## Phases
+
+1. **Discovery** - Understand plugin requirements
+2. **Architecture** - Design plugin structure
+3. **Commands** - Create slash commands
+4. **Agents** - Build specialized agents
+5. **Skills** - Define reusable skills
+6. **Hooks** - Implement event hooks
+7. **MCP Integration** - Add MCP server support
+8. **Validation** - Test and validate plugin
+
+## Bundled Agents
+
+- **agent-creator** - Creates specialized agents
+- **plugin-validator** - Validates plugin structure
+- **skill-reviewer** - Reviews skill definitions
+
+## Plugin Structure
+
+```
+plugin-name/
+├── .claude-plugin/
+│   └── plugin.json
+├── commands/
+│   └── my-command.md
+├── agents/
+│   └── my-agent.md
+├── skills/
+│   └── my-skill.md
+├── hooks/
+│   └── my-hook.js
+├── .mcp.json
+└── README.md
+```
+
+## Features
+
+- Automatic structure generation
+- Best practices validation
+- MCP server scaffolding
+- Documentation generation
+
+$ARGUMENTS

package/src/templates/official-plugins/pr-review-toolkit.md

@@ -0,0 +1,68 @@
+# /pr-review-toolkit:review-pr - Comprehensive PR Review
+
+Multi-faceted PR review with specialized analysis agents.
+
+## Usage
+
+```
+/pr-review-toolkit:review-pr 123
+/pr-review-toolkit:review-pr 123 --comments
+/pr-review-toolkit:review-pr 123 --tests
+/pr-review-toolkit:review-pr 123 --all
+```
+
+## Options
+
+| Option | Agent | Focus |
+|--------|-------|-------|
+| `--comments` | `comment-analyzer` | Review code comments quality |
+| `--tests` | `pr-test-analyzer` | Analyze test coverage and quality |
+| `--errors` | `silent-failure-hunter` | Find silent failures and error handling gaps |
+| `--types` | `type-design-analyzer` | TypeScript/type safety analysis |
+| `--code` | `code-reviewer` | General code quality review |
+| `--simplify` | `code-simplifier` | Find simplification opportunities |
+| `--all` | All agents | Comprehensive review |
+
+## Instructions
+
+When the user invokes `/pr-review-toolkit:review-pr`:
+
+1. **Fetch PR details**:
+   ```bash
+   gh pr view <number> --json files,additions,deletions,body
+   gh pr diff <number>
+   ```
+
+2. **Run selected agents in parallel**:
+   - Each agent analyzes their specific focus area
+   - Agents return findings with severity levels
+
+3. **Aggregate results**:
+   ```markdown
+   ## PR Review: #123
+
+   ### 🔴 Critical Issues
+   - [List critical findings]
+
+   ### 🟡 Warnings
+   - [List warnings]
+
+   ### 🟢 Suggestions
+   - [List suggestions]
+
+   ### Summary
+   - Files reviewed: X
+   - Issues found: Y
+   - Recommendation: APPROVE / REQUEST_CHANGES
+   ```
+
+## Agents
+
+| Agent | Purpose |
+|-------|---------|
+| `comment-analyzer` | Comment quality and documentation |
+| `pr-test-analyzer` | Test coverage and quality |
+| `silent-failure-hunter` | Error handling gaps |
+| `type-design-analyzer` | Type safety analysis |
+| `code-reviewer` | General code quality |
+| `code-simplifier` | Complexity reduction |

package/src/templates/official-plugins/ralph-loop.md

@@ -0,0 +1,51 @@
+# Ralph Loop
+
+Autonomous self-referential loops for task completion.
+
+## Commands
+
+### /ralph-loop
+Start an autonomous loop that continues until task is complete.
+
+### /cancel-ralph
+Stop the current loop.
+
+## Usage
+
+```
+/ralph-loop implement user authentication with tests
+/ralph-loop refactor the entire codebase to TypeScript
+/cancel-ralph
+```
+
+## How It Works
+
+1. **Task Analysis** - Breaks down the task into steps
+2. **Autonomous Execution** - Works through each step
+3. **Self-Verification** - Checks own work
+4. **Iteration** - Continues until complete
+5. **Stop Interception** - Prevents premature exit
+
+## Features
+
+- Persistent task memory
+- Self-correction capabilities
+- Progress tracking
+- Automatic error recovery
+- Completion verification
+
+## Use Cases
+
+- Large refactoring tasks
+- Multi-file implementations
+- Complex feature development
+- Codebase migrations
+- Comprehensive testing
+
+## Safety
+
+- /cancel-ralph to stop at any time
+- Periodic check-ins
+- Change summaries
+
+$ARGUMENTS

package/src/templates/official-plugins/security-guidance.md

@@ -0,0 +1,36 @@
+# Security Guidance
+
+Watches for risky security patterns during code edits and warns about potential vulnerabilities.
+
+## Usage
+
+This skill automatically activates during code edits to detect:
+
+## Detected Patterns
+
+1. **Command Injection** - Unsafe shell command construction
+2. **XSS (Cross-Site Scripting)** - Unescaped user input in HTML
+3. **eval() Usage** - Dynamic code execution risks
+4. **Dangerous HTML** - innerHTML with user data
+5. **Pickle Deserialization** - Python pickle security risks
+6. **os.system() Calls** - Unsafe system command execution
+7. **SQL Injection** - Unparameterized queries
+8. **Path Traversal** - Unsanitized file paths
+9. **Hardcoded Secrets** - API keys, passwords in code
+
+## How It Works
+
+- Hooks into PreToolUse events
+- Scans code changes for risky patterns
+- Provides warnings with remediation suggestions
+- Suggests secure alternatives
+
+## Example Warnings
+
+```
+⚠️ Potential Command Injection detected
+  Line 42: os.system(f"rm -rf {user_input}")
+  Suggestion: Use subprocess with shell=False and sanitize input
+```
+
+$ARGUMENTS