npm - @codeharbor/agent-playbook - Versions diffs - 0.1.0 → 0.1.1 - Mend

@codeharbor/agent-playbook 0.1.0 → 0.1.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 (113) hide show

package/package.json +5 -2
package/skills/api-designer/README.md +36 -0
package/skills/api-designer/SKILL.md +232 -0
package/skills/api-designer/references/graphql-patterns.md +12 -0
package/skills/api-designer/references/rest-patterns.md +17 -0
package/skills/api-designer/scripts/generate_api.py +87 -0
package/skills/api-designer/scripts/validate_api.py +48 -0
package/skills/api-documenter/README.md +41 -0
package/skills/api-documenter/SKILL.md +209 -0
package/skills/api-documenter/references/examples/README.md +3 -0
package/skills/api-documenter/references/examples/openapi-example.yaml +10 -0
package/skills/api-documenter/references/openapi-template.yaml +5 -0
package/skills/api-documenter/scripts/generate_openapi.py +84 -0
package/skills/api-documenter/scripts/validate_openapi.py +45 -0
package/skills/architecting-solutions/README.md +22 -0
package/skills/architecting-solutions/SKILL.md +459 -0
package/skills/auto-trigger/README.md +23 -0
package/skills/auto-trigger/SKILL.md +183 -0
package/skills/code-reviewer/README.md +59 -0
package/skills/code-reviewer/SKILL.md +220 -0
package/skills/code-reviewer/references/checklist.md +80 -0
package/skills/code-reviewer/references/patterns.md +226 -0
package/skills/code-reviewer/references/security.md +88 -0
package/skills/code-reviewer/scripts/review_checklist.py +191 -0
package/skills/commit-helper/README.md +58 -0
package/skills/commit-helper/SKILL.md +159 -0
package/skills/commit-helper/references/conventional-commits.md +68 -0
package/skills/commit-helper/references/examples.md +125 -0
package/skills/commit-helper/references/scopes.md +49 -0
package/skills/commit-helper/scripts/validate_commit.py +70 -0
package/skills/create-pr/README.md +182 -0
package/skills/create-pr/SKILL.md +340 -0
package/skills/debugger/README.md +53 -0
package/skills/debugger/SKILL.md +239 -0
package/skills/debugger/references/checklist.md +7 -0
package/skills/debugger/references/errors.md +6 -0
package/skills/debugger/references/patterns.md +5 -0
package/skills/debugger/scripts/debug_report.py +77 -0
package/skills/deployment-engineer/README.md +40 -0
package/skills/deployment-engineer/SKILL.md +242 -0
package/skills/deployment-engineer/references/kubernetes.md +23 -0
package/skills/deployment-engineer/references/monitoring.md +14 -0
package/skills/deployment-engineer/references/pipelines.md +12 -0
package/skills/deployment-engineer/scripts/generate_deploy.py +72 -0
package/skills/deployment-engineer/scripts/validate_deploy.py +46 -0
package/skills/documentation-engineer/README.md +41 -0
package/skills/documentation-engineer/SKILL.md +164 -0
package/skills/documentation-engineer/references/api-template.md +22 -0
package/skills/documentation-engineer/references/readme-template.md +25 -0
package/skills/documentation-engineer/references/style-guide.md +13 -0
package/skills/documentation-engineer/scripts/generate_docs.py +68 -0
package/skills/documentation-engineer/scripts/validate_docs.py +46 -0
package/skills/figma-designer/README.md +222 -0
package/skills/figma-designer/SKILL.md +407 -0
package/skills/figma-designer/references/example-output.md +86 -0
package/skills/performance-engineer/README.md +42 -0
package/skills/performance-engineer/SKILL.md +236 -0
package/skills/performance-engineer/references/checklist.md +6 -0
package/skills/performance-engineer/references/monitoring.md +5 -0
package/skills/performance-engineer/references/optimization.md +7 -0
package/skills/performance-engineer/scripts/perf_report.py +64 -0
package/skills/performance-engineer/scripts/profile.py +63 -0
package/skills/planning-with-files/README.md +27 -0
package/skills/planning-with-files/SKILL.md +103 -0
package/skills/prd-implementation-precheck/README.md +97 -0
package/skills/prd-implementation-precheck/SKILL.md +112 -0
package/skills/prd-planner/README.md +102 -0
package/skills/prd-planner/SKILL.md +449 -0
package/skills/prd-planner/references/edge-case-analysis.md +111 -0
package/skills/qa-expert/README.md +37 -0
package/skills/qa-expert/SKILL.md +225 -0
package/skills/qa-expert/references/gates.md +11 -0
package/skills/qa-expert/references/metrics.md +6 -0
package/skills/qa-expert/references/strategy.md +11 -0
package/skills/qa-expert/scripts/coverage_analysis.py +61 -0
package/skills/qa-expert/scripts/generate_test_plan.py +68 -0
package/skills/refactoring-specialist/README.md +37 -0
package/skills/refactoring-specialist/SKILL.md +283 -0
package/skills/refactoring-specialist/references/checklist.md +6 -0
package/skills/refactoring-specialist/references/smells.md +6 -0
package/skills/refactoring-specialist/references/techniques.md +6 -0
package/skills/security-auditor/README.md +48 -0
package/skills/security-auditor/SKILL.md +256 -0
package/skills/security-auditor/references/checklist.md +7 -0
package/skills/security-auditor/references/owasp.md +12 -0
package/skills/security-auditor/references/remediation.md +7 -0
package/skills/security-auditor/scripts/find_secrets.py +58 -0
package/skills/security-auditor/scripts/security_audit.py +64 -0
package/skills/self-improving-agent/README.md +136 -0
package/skills/self-improving-agent/SKILL.md +407 -0
package/skills/self-improving-agent/hooks/post-bash.sh +10 -0
package/skills/self-improving-agent/hooks/pre-tool.sh +10 -0
package/skills/self-improving-agent/hooks/session-end.sh +4 -0
package/skills/self-improving-agent/memory/semantic-patterns.json +288 -0
package/skills/self-improving-agent/references/appendix.md +131 -0
package/skills/self-improving-agent/templates/correction-template.md +11 -0
package/skills/self-improving-agent/templates/pattern-template.md +15 -0
package/skills/self-improving-agent/templates/validation-template.md +14 -0
package/skills/session-logger/README.md +50 -0
package/skills/session-logger/SKILL.md +156 -0
package/skills/skill-router/README.md +155 -0
package/skills/skill-router/SKILL.md +215 -0
package/skills/test-automator/README.md +41 -0
package/skills/test-automator/SKILL.md +202 -0
package/skills/test-automator/references/best-practices.md +6 -0
package/skills/test-automator/references/examples/README.md +3 -0
package/skills/test-automator/references/examples/unit-test-example.md +8 -0
package/skills/test-automator/references/mocking.md +5 -0
package/skills/test-automator/scripts/coverage_report.py +59 -0
package/skills/test-automator/scripts/generate_test.py +66 -0
package/skills/workflow-orchestrator/README.md +20 -0
package/skills/workflow-orchestrator/SKILL.md +342 -0
package/src/cli.js +25 -10

package/skills/create-pr/SKILL.md ADDED Viewed

@@ -0,0 +1,340 @@
+---
+name: create-pr
+description: Creates pull requests with bilingual documentation updates. Use when user asks to create PR, make a pull request, or submit changes for review. Automatically updates both English and Chinese README files.
+allowed-tools: Read, Write, Edit, Bash, Grep, AskUserQuestion
+---
+# Create PR
+A skill for creating pull requests with automatic bilingual documentation updates. This skill ensures that both English and Chinese documentation stay in sync when code changes are submitted.
+## When This Skill Activates
+This skill activates when you:
+- Ask to create a pull request or PR
+- Say "submit my changes" or "push and create PR"
+- Mention "make a PR" or "open a pull request"
+- Want to submit code for review
+## PR Creation Workflow
+### Step 1: Analyze Changes
+Examine all changes in the current branch:
+```bash
+git status
+git diff
+git log --oneline main..HEAD
+```
+Identify:
+- **Modified files**: What was changed?
+- **New files**: What was added?
+- **Deleted files**: What was removed?
+- **Impact area**: Which skills or features are affected?
+### Step 2: Determine Documentation Updates
+### Check for Skill Changes
+First, detect if any skills were changed:
+```bash
+# Check if skills/ directory has changes
+git diff --name-only main..HEAD | grep "^skills/"
+```
+### Decision Matrix
+| Change Type | Documentation Action |
+|-------------|---------------------|
+| New skill added | Add to skills table in both EN and CN README |
+| Skill description changed | Update description in skills table |
+| Skill removed | Remove from skills table |
+| Skill hooks changed | Update Auto-Trigger column in skills table |
+| Internal skill logic only | Skip README update |
+| Bug fix with no user impact | Skip README update |
+### Auto-Trigger Changes Require Update
+If a skill's `hooks:` front matter was modified, the **Auto-Trigger** column in the Skills Catalog must be updated:
+```bash
+# Check if hooks were modified
+git diff main..HEAD -- skills/*/SKILL.md | grep -E "^\+.*hooks:|^\+.*trigger:"
+```
+If hooks changed → Update README.md and README.zh-CN.md Auto-Trigger column.
+### Step 3: Draft Commit Message
+Use the `commit-helper` format:
+```
+<type>(<scope>): <subject>
+<body>
+<footer>
+```
+Types:
+- `feat`: New skill or feature
+- `fix`: Bug fix or correction
+- `docs`: Documentation only changes
+- `refactor`: Code refactoring
+- `chore`: Maintenance tasks
+### Step 4: Create the Pull Request
+Run the following sequence:
+```bash
+# 1. Stage and commit changes
+git add .
+git commit -m "commit message"
+# 2. Push to remote
+git push -u origin <branch-name>
+# 3: Create PR using gh CLI
+gh pr create \
+  --title "PR title" \
+  --body "PR description"
+```
+### Step 5: Update Documentation (If Required)
+After creating the PR, update both README files:
+**README.md** (English):
+- Add new skills to appropriate category table
+- Update project structure if needed
+- Keep language switch link at top
+**README.zh-CN.md** (Chinese):
+- Mirror all English changes
+- Translate skill descriptions
+- Maintain same structure and formatting
+### Step 6: Update Changelog (Optional)
+For significant changes, add to CHANGELOG.md:
+```markdown
+## [Version] - YYYY-MM-DD
+### Added
+- New skill: skill-name
+### Fixed
+- Fixed issue in skill-name
+### Changed
+- Updated skill-name with new features
+```
+## Documentation Update Guidelines
+### Skills Catalog Update Template
+When adding or modifying skills, use this format for the Skills Catalog:
+**English (README.md):**
+```markdown
+### Category Name
+| Skill | Description | Auto-Trigger |
+|-------|-------------|--------------|
+| **[skill-name](./skills/skill-name/)** | Brief description | Manual / Auto / Background / (keyword: "...") |
+```
+**Chinese (README.zh-CN.md):**
+```markdown
+### 类别名称
+| 技能 | 描述 | 自动触发 |
+|------|------|----------|
+| **[skill-name](./skills/skill-name/)** | 简短描述 | 手动 / 自动 / 后台 / (关键词："...") |
+```
+### Auto-Trigger Column Values
+| Value | Meaning | Example |
+|-------|---------|---------|
+| `Manual` | User must invoke | Most development skills |
+| `Auto` | Triggers automatically after any skill | session-logger |
+| `Background` | Runs non-blocking after related skill | self-improving-agent |
+| `After skill updates` | Only triggers when skills are modified | create-pr |
+| `(keyword: "...")` | Activates on specific keyword | prd-planner (keyword: "PRD") |
+### When to Update README
+**Always update when:**
+- Adding a new skill
+- Removing a skill
+- Changing skill names or descriptions
+- Restructuring the skills directory
+**Consider updating when:**
+- Adding significant features to existing skills
+- Changing installation instructions
+- Modifying project structure
+**Skip updating when:**
+- Internal code refactoring with no user impact
+- Minor typo fixes
+- Test file changes
+### Bilingual Update Format
+When adding a new skill to the skills table:
+**English (README.md):**
+```markdown
+| **[skill-name](./skills/skill-name/)** | Brief skill description |
+```
+**Chinese (README.zh-CN.md):**
+```markdown
+| **[skill-name](./skills/skill-name/)** | 技能简短描述 |
+```
+### Language Switch Link
+Both README files must have the language switch at the top:
+**README.md:**
+```markdown
+English | [简体中文](./README.zh-CN.md)
+```
+**README.zh-CN.md:**
+```markdown
+[English](./README.md) | 简体中文
+```
+## PR Description Template
+When creating a PR, use this template:
+```markdown
+## Summary
+<Brief description of what this PR does>
+## Changes
+- [ ] New skill added
+- [ ] Existing skill modified
+- [ ] Documentation updated
+- [ ] Tests added/updated
+## Skills Affected
+- `skill-name`: Description of change
+## Documentation
+- [x] README.md updated
+- [x] README.zh-CN.md updated
+- [ ] CHANGELOG.md updated (if applicable)
+## Test Plan
+- [ ] Skill tested in Claude Code
+- [ ] Documentation links verified
+- [ ] Bilingual translations checked
+---
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+```
+## Common Scenarios
+### Scenario 1: Adding a New Skill
+```bash
+# 1. Create skill files
+mkdir -p skills/new-skill
+touch skills/new-skill/SKILL.md
+touch skills/new-skill/README.md
+# 2. Create symlink
+ln -s ~/path/to/agent-playbook/skills/new-skill/SKILL.md ~/.claude/skills/new-skill.md
+# 3. Update README.md (add to skills table)
+# 4. Update README.zh-CN.md (add to skills table with translation)
+# 5. Commit and push
+git add skills/new-skill/ README.md README.zh-CN.md
+git commit -m "feat: add new-skill for ..."
+git push -u origin feature/add-new-skill
+# 6. Create PR
+gh pr create --title "feat: add new-skill" --body "..."
+```
+### Scenario 2: Modifying an Existing Skill
+```bash
+# 1. Make changes to skill
+vim skills/existing-skill/SKILL.md
+# 2. Check if description changed
+git diff skills/existing-skill/SKILL.md
+# 3. If description changed, update README files
+# 4. Commit, push, create PR
+```
+### Scenario 3: Bug Fix Only
+```bash
+# 1. Fix the bug
+vim skills/some-skill/SKILL.md
+# 2. Commit and push (no README update needed)
+git add skills/some-skill/SKILL.md
+git commit -m "fix: correct typo in some-skill"
+git push
+# 3. Create PR
+gh pr create --title "fix: correct typo in some-skill"
+```
+## Verification Checklist
+Before creating the PR, verify:
+- [ ] All changes are committed
+- [ ] Branch is pushed to remote
+- [ ] Commit messages follow Conventional Commits
+- [ ] README.md is updated if needed
+- [ ] README.zh-CN.md is updated if needed
+- [ ] Language switch links are present in both READMEs
+- [ ] New skills have symlinks created
+- [ ] PR title is clear and descriptive
+- [ ] PR description includes summary and changes
+## Quick Reference
+| Command | Purpose |
+|---------|---------|
+| `git status` | Check current state |
+| `git diff` | See unstaged changes |
+| `git log main..HEAD` | See branch commits |
+| `git add .` | Stage all changes |
+| `git commit -m "msg"` | Commit with message |
+| `git push -u origin branch` | Push to remote |
+| `gh pr create` | Create pull request |
+## Tips
+1. **Commit first, PR later**: Always commit changes before creating PR
+2. **Small PRs**: Keep PRs focused on a single change
+3. **Clear titles**: Use Conventional Commits in PR titles
+4. **Bilingual sync**: Always update both README files together
+5. **Test skills**: Verify skills work before submitting PR

package/skills/debugger/README.md ADDED Viewed

@@ -0,0 +1,53 @@
+# Debugger
+> A Claude Code skill for systematic debugging and issue resolution.
+## Installation
+This skill is part of the [agent-playbook](https://github.com/Charon-Fan/agent-playbook) collection.
+## Usage
+When encountering an error or bug:
+```
+You: This function is throwing an error
+You: Debug this code
+You: Why isn't this working?
+```
+The skill will:
+1. Analyze the error message
+2. Trace the root cause
+3. Provide debugging steps
+4. Suggest fixes
+## Debugging Process
+| Phase | Description |
+|-------|-------------|
+| **Understand** | Reproduce and understand the problem |
+| **Isolate** | Narrow down the source of the issue |
+| **Analyze** | Determine root cause |
+| **Fix** | Implement and verify the solution |
+## Common Error Types
+| Error | Cause | Solution |
+|-------|-------|----------|
+| TypeError | Wrong type, null reference | Add null check, verify type |
+| ReferenceError | Variable not defined | Check imports, scope |
+| NetworkError | Connection issues | Check endpoint, CORS |
+| TimeoutError | Request too slow | Optimize query, increase timeout |
+## Scripts
+Generate debug report:
+```bash
+python scripts/debug_report.py "<error-message>"
+```
+## Resources
+- [Debugging Best Practices](https://google.github.io/eng-practices/debugging/)
+- [Systematic Debugging](https://www.amazon.com/Debugging-Software-Technical-Charles-Schooleary/dp/0132519560)

package/skills/debugger/SKILL.md ADDED Viewed

@@ -0,0 +1,239 @@
+---
+name: debugger
+description: Advanced debugging specialist for diagnosing and resolving code issues. Use when user encounters bugs, errors, unexpected behavior, or mentions debugging.
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+# Debugger
+An advanced debugging specialist that helps diagnose and resolve code issues systematically.
+## When This Skill Activates
+Activates when you:
+- Report an error or bug
+- Mention "debug this" or "help debug"
+- Describe unexpected behavior
+- Ask why something isn't working
+## Debugging Process
+### Phase 1: Understand the Problem
+1. **Reproduce the issue**
+   - What are the exact steps to reproduce?
+   - What is the expected behavior?
+   - What is the actual behavior?
+   - What error messages appear?
+2. **Gather context**
+   ```bash
+   # Check recent changes
+   git log --oneline -10
+   # Check error logs
+   tail -f logs/error.log
+   # Check environment
+   env | grep -i debug
+   ```
+### Phase 2: Isolate the Issue
+1. **Locate the error source**
+   - Stack trace analysis
+   - Error code lookup
+   - Log correlation
+2. **Narrow down scope**
+   - Binary search (comment out half)
+   - Minimize reproduction case
+   - Identify affected components
+### Phase 3: Analyze the Root Cause
+#### Common Error Categories
+| Category | Symptoms | Investigation Steps |
+|----------|----------|---------------------|
+| **Null/Undefined** | "Cannot read X of undefined" | Trace the variable origin |
+| **Type Errors** | "X is not a function" | Check actual vs expected type |
+| **Async Issues** | Race conditions, timing | Check promise handling, async/await |
+| **State Issues** | Stale data, wrong state | Trace state mutations |
+| **Network** | Timeouts, connection refused | Check endpoints, CORS, auth |
+| **Environment** | Works locally, not in prod | Compare env vars, versions |
+| **Memory** | Leaks, OOM | Profile memory usage |
+| **Concurrency** | Deadlocks, race conditions | Check locks, shared state |
+### Phase 4: Form Hypotheses
+For each potential cause:
+1. Form a hypothesis
+2. Create a test to validate
+3. Run the test
+4. Confirm or reject
+### Phase 5: Fix and Verify
+1. **Implement the fix**
+2. **Add logging if needed**
+3. **Test the fix**
+4. **Add regression test**
+## Debugging Commands
+### General Debugging
+```bash
+# Find recently modified files
+find . -type f -mtime -1 -name "*.js" -o -name "*.ts" -o -name "*.py"
+# Grep for error patterns
+grep -r "ERROR\|FATAL\|Exception" logs/
+# Search for suspicious patterns
+grep -r "TODO\|FIXME\|XXX" src/
+# Check for console.log left in code
+grep -r "console\.log\|debugger" src/
+```
+### Language-Specific
+**JavaScript/TypeScript:**
+```bash
+# Run with debug output
+NODE_DEBUG=* node app.js
+# Check syntax
+node -c file.js
+# Run tests in debug mode
+npm test -- --inspect-brk
+```
+**Python:**
+```bash
+# Run with pdb
+python -m pdb script.py
+# Check syntax
+python -m py_compile script.py
+# Verbose mode
+python -v script.py
+```
+**Go:**
+```bash
+# Race detection
+go run -race main.go
+# Debug build
+go build -gcflags="-N -l"
+# Profile
+go test -cpuprofile=cpu.prof
+```
+## Common Debugging Patterns
+### Pattern 1: Divide and Conquer
+```python
+# When you don't know where the bug is:
+def process():
+    step1()
+    step2()
+    step3()
+    step4()
+# Comment out half:
+def process():
+    step1()
+    # step2()
+    # step3()
+    # step4()
+# If bug disappears, uncomment half of commented:
+def process():
+    step1()
+    step2()
+    # step3()
+    # step4()
+# Continue until you isolate the bug
+```
+### Pattern 2: Add Logging
+```typescript
+// Before (mysterious failure):
+async function getUser(id: string) {
+  const user = await db.find(id);
+  return transform(user);
+}
+// After (with logging):
+async function getUser(id: string) {
+  console.log('[DEBUG] getUser called with id:', id);
+  const user = await db.find(id);
+  console.log('[DEBUG] db.find returned:', user);
+  const result = transform(user);
+  console.log('[DEBUG] transform returned:', result);
+  return result;
+}
+```
+### Pattern 3: Minimal Reproduction
+```typescript
+// Complex code with bug:
+function processBatch(items, options) {
+  // 100 lines of complex logic
+}
+// Create minimal reproduction:
+function processBatch(items, options) {
+  console.log('Items:', items.length);
+  console.log('Options:', options);
+  // Test with minimal data
+  return processBatch([items[0]], options);
+}
+```
+## Error Message Analysis
+### Common Error Messages
+| Error | Likely Cause | Solution |
+|-------|--------------|----------|
+| `Cannot read property 'X' of undefined` | Accessing property on null/undefined | Add null check, use optional chaining |
+| `X is not a function` | Wrong type, shadowing | Check typeof, verify import |
+| `Unexpected token` | Syntax error | Check line before error, validate syntax |
+| `Module not found` | Import path wrong | Check relative path, verify file exists |
+| `EADDRINUSE` | Port already in use | Kill existing process, use different port |
+| `Connection refused` | Service not running | Start service, check port |
+| `Timeout` | Request too slow | Increase timeout, check network |
+## Debugging Checklist
+- [ ] I can reproduce the issue consistently
+- [ ] I have identified the exact error location
+- [ ] I understand the root cause
+- [ ] I have a proposed fix
+- [ ] The fix doesn't break existing functionality
+- [ ] I've added a test to prevent regression
+## Scripts
+Generate a debug report:
+```bash
+python scripts/debug_report.py <error-message>
+```
+## References
+- `references/checklist.md` - Debugging checklist
+- `references/patterns.md` - Common debugging patterns
+- `references/errors.md` - Error message reference

package/skills/debugger/references/checklist.md ADDED Viewed

@@ -0,0 +1,7 @@
+# Debugging Checklist
+- [ ] Reproduce the issue
+- [ ] Isolate the failure
+- [ ] Identify root cause
+- [ ] Implement fix
+- [ ] Add regression coverage

package/skills/debugger/references/errors.md ADDED Viewed

@@ -0,0 +1,6 @@
+# Common Error Types
+- Null/undefined access
+- Race conditions
+- Configuration mismatches
+- Data shape drift

package/skills/debugger/references/patterns.md ADDED Viewed

@@ -0,0 +1,5 @@
+# Debugging Patterns
+- Binary search the change set
+- Add targeted logging
+- Reduce problem scope with minimal repros