thanh-kit 2.5.0 → 2.5.2

package/templates/skills/developer-growth-analysis/SKILL.md

@@ -1,322 +0,0 @@
----
-name: developer-growth-analysis
-description: Analyzes your recent Claude Code chat history to identify coding patterns, development gaps, and areas for improvement, curates relevant learning resources from HackerNews, and automatically sends a personalized growth report to your Slack DMs.
----
-
-# Developer Growth Analysis
-
-This skill provides personalized feedback on your recent coding work by analyzing your Claude Code chat interactions and identifying patterns that reveal strengths and areas for growth.
-
-## When to Use This Skill
-
-Use this skill when you want to:
-- Understand your development patterns and habits from recent work
-- Identify specific technical gaps or recurring challenges
-- Discover which topics would benefit from deeper study
-- Get curated learning resources tailored to your actual work patterns
-- Track improvement areas across your recent projects
-- Find high-quality articles that directly address the skills you're developing
-
-This skill is ideal for developers who want structured feedback on their growth without waiting for code reviews, and who prefer data-driven insights from their own work history.
-
-## What This Skill Does
-
-This skill performs a six-step analysis of your development work:
-
-1. **Reads Your Chat History**: Accesses your local Claude Code chat history from the past 24-48 hours to understand what you've been working on.
-
-2. **Identifies Development Patterns**: Analyzes the types of problems you're solving, technologies you're using, challenges you encounter, and how you approach different kinds of tasks.
-
-3. **Detects Improvement Areas**: Recognizes patterns that suggest skill gaps, repeated struggles, inefficient approaches, or areas where you might benefit from deeper knowledge.
-
-4. **Generates a Personalized Report**: Creates a comprehensive report showing your work summary, identified improvement areas, and specific recommendations for growth.
-
-5. **Finds Learning Resources**: Uses HackerNews to curate high-quality articles and discussions directly relevant to your improvement areas, providing you with a reading list tailored to your actual development work.
-
-6. **Sends to Your Slack DMs**: Automatically delivers the complete report to your own Slack direct messages so you can reference it anytime, anywhere.
-
-## How to Use
-
-Ask Claude to analyze your recent coding work:
-
-```
-Analyze my developer growth from my recent chats
-```
-
-Or be more specific about which time period:
-
-```
-Analyze my work from today and suggest areas for improvement
-```
-
-The skill will generate a formatted report with:
-- Overview of your recent work
-- Key improvement areas identified
-- Specific recommendations for each area
-- Curated learning resources from HackerNews
-- Action items you can focus on
-
-## Instructions
-
-When a user requests analysis of their developer growth or coding patterns from recent work:
-
-1. **Access Chat History**
-
-   Read the chat history from `~/.claude/history.jsonl`. This file is a JSONL format where each line contains:
-   - `display`: The user's message/request
-   - `project`: The project being worked on
-   - `timestamp`: Unix timestamp (in milliseconds)
-   - `pastedContents`: Any code or content pasted
-
-   Filter for entries from the past 24-48 hours based on the current timestamp.
-
-2. **Analyze Work Patterns**
-
-   Extract and analyze the following from the filtered chats:
-   - **Projects and Domains**: What types of projects was the user working on? (e.g., backend, frontend, DevOps, data, etc.)
-   - **Technologies Used**: What languages, frameworks, and tools appear in the conversations?
-   - **Problem Types**: What categories of problems are being solved? (e.g., performance optimization, debugging, feature implementation, refactoring, setup/configuration)
-   - **Challenges Encountered**: What problems did the user struggle with? Look for:
-     - Repeated questions about similar topics
-     - Problems that took multiple attempts to solve
-     - Questions indicating knowledge gaps
-     - Complex architectural decisions
-   - **Approach Patterns**: How does the user solve problems? (e.g., methodical, exploratory, experimental)
-
-3. **Identify Improvement Areas**
-
-   Based on the analysis, identify 3-5 specific areas where the user could improve. These should be:
-   - **Specific** (not vague like "improve coding skills")
-   - **Evidence-based** (grounded in actual chat history)
-   - **Actionable** (practical improvements that can be made)
-   - **Prioritized** (most impactful first)
-
-   Examples of good improvement areas:
-   - "Advanced TypeScript patterns (generics, utility types, type guards) - you struggled with type safety in [specific project]"
-   - "Error handling and validation - I noticed you patched several bugs related to missing null checks"
-   - "Async/await patterns - your recent work shows some race conditions and timing issues"
-   - "Database query optimization - you rewrote the same query multiple times"
-
-4. **Generate Report**
-
-   Create a comprehensive report with this structure:
-
-   ```markdown
-   # Your Developer Growth Report
-
-   **Report Period**: [Yesterday / Today / [Custom Date Range]]
-   **Last Updated**: [Current Date and Time]
-
-   ## Work Summary
-
-   [2-3 paragraphs summarizing what the user worked on, projects touched, technologies used, and overall focus areas]
-
-   Example:
-   "Over the past 24 hours, you focused primarily on backend development with three distinct projects. Your work involved TypeScript, React, and deployment infrastructure. You tackled a mix of feature implementation, debugging, and architectural decisions, with a particular focus on API design and database optimization."
-
-   ## Improvement Areas (Prioritized)
-
-   ### 1. [Area Name]
-
-   **Why This Matters**: [Explanation of why this skill is important for the user's work]
-
-   **What I Observed**: [Specific evidence from chat history showing this gap]
-
-   **Recommendation**: [Concrete step(s) to improve in this area]
-
-   **Time to Skill Up**: [Brief estimate of effort required]
-
-   ---
-
-   [Repeat for 2-4 additional areas]
-
-   ## Strengths Observed
-
-   [2-3 bullet points highlighting things you're doing well - things to continue doing]
-
-   ## Action Items
-
-   Priority order:
-   1. [Action item derived from highest priority improvement area]
-   2. [Action item from next area]
-   3. [Action item from next area]
-
-   ## Learning Resources
-
-   [Will be populated in next step]
-   ```
-
-5. **Search for Learning Resources**
-
-   Use Rube MCP to search HackerNews for articles related to each improvement area:
-
-   - For each improvement area, construct a search query targeting high-quality resources
-   - Search HackerNews using RUBE_SEARCH_TOOLS with queries like:
-     - "Learn [Technology/Pattern] best practices"
-     - "[Technology] advanced patterns and techniques"
-     - "Debugging [specific problem type] in [language]"
-   - Prioritize posts with high engagement (comments, upvotes)
-   - For each area, include 2-3 most relevant articles with:
-     - Article title
-     - Publication date
-     - Brief description of why it's relevant
-     - Link to the article
-
-   Add this section to the report:
-
-   ```markdown
-   ## Curated Learning Resources
-
-   ### For: [Improvement Area]
-
-   1. **[Article Title]** - [Date]
-      [Description of what it covers and why it's relevant to your improvement area]
-      [Link]
-
-   2. **[Article Title]** - [Date]
-      [Description]
-      [Link]
-
-   [Repeat for other improvement areas]
-   ```
-
-6. **Present the Complete Report**
-
-   Deliver the report in a clean, readable format that the user can:
-   - Quickly scan for key takeaways
-   - Use for focused learning planning
-   - Reference over the next week as they work on improvements
-   - Share with mentors if they want external feedback
-
-7. **Send Report to Slack DMs**
-
-   Use Rube MCP to send the complete report to the user's own Slack DMs:
-
-   - Check if Slack connection is active via RUBE_SEARCH_TOOLS
-   - If not connected, use RUBE_MANAGE_CONNECTIONS to initiate Slack auth
-   - Use RUBE_MULTI_EXECUTE_TOOL to send the report as a formatted message:
-     - Send the report title and period as the first message
-     - Break the report into logical sections (Summary, Improvements, Strengths, Actions, Resources)
-     - Format each section as a well-structured Slack message with proper markdown
-     - Include clickable links for the learning resources
-   - Confirm delivery in the CLI output
-
-   This ensures the user has the report in a place they check regularly and can reference it throughout the week.
-
-## Example Usage
-
-### Input
-
-```
-Analyze my developer growth from my recent chats
-```
-
-### Output
-
-```markdown
-# Your Developer Growth Report
-
-**Report Period**: November 9-10, 2024
-**Last Updated**: November 10, 2024, 9:15 PM UTC
-
-## Work Summary
-
-Over the past two days, you focused on backend infrastructure and API development. Your primary project was an open-source showcase application, where you made significant progress on connections management, UI improvements, and deployment configuration. You worked with TypeScript, React, and Node.js, tackling challenges ranging from data security to responsive design. Your work shows a balance between implementing features and addressing technical debt.
-
-## Improvement Areas (Prioritized)
-
-### 1. Advanced TypeScript Patterns and Type Safety
-
-**Why This Matters**: TypeScript is central to your work, but leveraging its advanced features (generics, utility types, conditional types, type guards) can significantly improve code reliability and reduce runtime errors. Better type safety catches bugs at compile time rather than in production.
-
-**What I Observed**: In your recent chats, you were working with connection data structures and struggled a few times with typing auth configurations properly. You also had to iterate on union types for different connection states. There's an opportunity to use discriminated unions and type guards more effectively.
-
-**Recommendation**: Study TypeScript's advanced type system, particularly utility types (Omit, Pick, Record), conditional types, and discriminated unions. Apply these patterns to your connection configuration handling and auth state management.
-
-**Time to Skill Up**: 5-8 hours of focused learning and practice
-
-### 2. Secure Data Handling and Information Hiding in UI
-
-**Why This Matters**: You identified and fixed a security concern where sensitive connection data was being displayed in your console. Preventing information leakage is critical for applications handling user credentials and API keys. Good practices here prevent security incidents and user trust violations.
-
-**What I Observed**: You caught that your "Your Apps" page was showing full connection data including auth configs. This shows good security instincts, and the next step is building this into your default thinking when handling sensitive information.
-
-**Recommendation**: Review security best practices for handling sensitive data in frontend applications. Create reusable patterns for filtering/masking sensitive information before displaying it. Consider implementing a secure data layer that explicitly whitelist what can be shown in the UI.
-
-**Time to Skill Up**: 3-4 hours
-
-### 3. Component Architecture and Responsive UI Patterns
-
-**Why This Matters**: You're designing UIs that need to work across different screen sizes and user interactions. Strong component architecture makes it easier to build complex UIs without bugs and improves maintainability.
-
-**What I Observed**: You worked on the "Marketplace" UI (formerly Browse Tools), recreating it from a design image. You also identified and fixed scrolling issues where content was overflowing containers. There's an opportunity to strengthen your understanding of layout containment and responsive design patterns.
-
-**Recommendation**: Study React component composition patterns and CSS layout best practices (especially flexbox and grid). Focus on container queries and responsive patterns that prevent overflow issues. Look into component composition libraries and design system approaches.
-
-**Time to Skill Up**: 6-10 hours (depending on depth)
-
-## Strengths Observed
-
-- **Security Awareness**: You proactively identified data leakage issues before they became problems
-- **Iterative Refinement**: You worked through UI requirements methodically, asking clarifying questions and improving designs
-- **Full-Stack Capability**: You comfortably work across backend APIs, frontend UI, and deployment concerns
-- **Problem-Solving Approach**: You break down complex tasks into manageable steps
-
-## Action Items
-
-Priority order:
-1. Spend 1-2 hours learning TypeScript utility types and discriminated unions; apply to your connection data structures
-2. Document security patterns for your project (what data is safe to display, filtering/masking functions)
-3. Study one article on advanced React patterns and apply one pattern to your current UI work
-4. Set up a code review checklist focused on type safety and data security for future PRs
-
-## Curated Learning Resources
-
-### For: Advanced TypeScript Patterns
-
-1. **TypeScript's Advanced Types: Generics, Utility Types, and Conditional Types** - HackerNews, October 2024
-   Deep dive into TypeScript's type system with practical examples and real-world applications. Covers discriminated unions, type guards, and patterns for ensuring compile-time safety in complex applications.
-   [Link to discussion]
-
-2. **Building Type-Safe APIs in TypeScript** - HackerNews, September 2024
-   Practical guide to designing APIs with TypeScript that catch errors early. Particularly relevant for your connection configuration work.
-   [Link to discussion]
-
-### For: Secure Data Handling in Frontend
-
-1. **Preventing Information Leakage in Web Applications** - HackerNews, August 2024
-   Comprehensive guide to data security in frontend applications, including filtering sensitive information, secure logging, and audit trails.
-   [Link to discussion]
-
-2. **OAuth and API Key Management Best Practices** - HackerNews, July 2024
-   How to safely handle authentication tokens and API keys in applications, with examples for different frameworks.
-   [Link to discussion]
-
-### For: Component Architecture and Responsive Design
-
-1. **Advanced React Patterns: Composition Over Configuration** - HackerNews
-   Explores component composition strategies that scale, with examples using modern React patterns.
-   [Link to discussion]
-
-2. **CSS Layout Mastery: Flexbox, Grid, and Container Queries** - HackerNews, October 2024
-   Learn responsive design patterns that prevent overflow issues and work across all screen sizes.
-   [Link to discussion]
-```
-
-## Tips and Best Practices
-
-- Run this analysis once a week to track your improvement trajectory over time
-- Pick one improvement area at a time and focus on it for a few days before moving to the next
-- Use the learning resources as a study guide; work through the recommended materials and practice applying the patterns
-- Revisit this report after focusing on an area for a week to see how your work patterns change
-- The learning resources are intentionally curated for your actual work, not generic topics, so they'll be highly relevant to what you're building
-
-## How Accuracy and Quality Are Maintained
-
-This skill:
-- Analyzes your actual work patterns from timestamped chat history
-- Generates evidence-based recommendations grounded in real projects
-- Curates learning resources that directly address your identified gaps
-- Focuses on actionable improvements, not vague feedback
-- Provides specific time estimates based on complexity
-- Prioritizes areas that will have the most impact on your development velocity

package/templates/skills/documentation/SKILL.md

@@ -1,134 +0,0 @@
----
-name: documentation
-description: Use for PLANNING documentation with phased analysis (4 phases), gap identification, and structured knowledge modeling. Best for documentation audits, completeness analysis, and documentation strategy planning. NOT for writing actual docs (use tasks-documentation instead).
-allowed-tools: Read, Write, Edit, Bash, Grep, Glob, Task, TodoWrite
----
-
-# Documentation Enhancement
-
-You are to operate as an expert technical writer and software documentation specialist to enhance documentation.
-
-**IMPORTANT**: Always thinks hard, plan step by step to-do list first before execute. Always remember to-do list, never compact or summary it when memory context limit reach. Always preserve and carry your to-do list through every operation.
-
----
-
-## Core Anti-Hallucination Protocols
-
-### ASSUMPTION_VALIDATION_CHECKPOINT
-
-Before every major operation:
-
-1. "What assumptions am I making about [X]?"
-2. "Have I verified this with actual code evidence?"
-3. "Could I be wrong about [specific pattern/relationship]?"
-
-### EVIDENCE_CHAIN_VALIDATION
-
-Before claiming any relationship:
-
-- "I believe X calls Y because..." → show actual code
-- "This follows pattern Z because..." → cite specific examples
-
-### TOOL_EFFICIENCY_PROTOCOL
-
-- Batch multiple Grep searches into single calls with OR patterns
-- Use parallel Read operations for related files
-- Combine semantic searches with related keywords
-
-### CONTEXT_ANCHOR_SYSTEM
-
-Every 10 operations:
-
-1. Re-read the original task description
-2. Verify the current operation aligns with original goals
-3. Update the `Current Focus` in `## Progress` section
-
----
-
-## PHASE 1: EXTERNAL MEMORY-DRIVEN DOCUMENTATION ANALYSIS
-
-Build a structured knowledge model in `ai_task_analysis_notes/[task-name].ai_task_analysis_notes_temp.md`.
-
-### PHASE 1A: INITIALIZATION AND DISCOVERY
-
-1. **Initialize** the analysis file with standard headings
-2. **Discovery searches** for all related files
-
-### DOCUMENTATION-SPECIFIC DISCOVERY
-
-**DOCUMENTATION_COMPLETENESS_DISCOVERY**: Focus on documentation-relevant patterns:
-
-1. **API Documentation Analysis**: Find API endpoints and identify missing documentation. Document under `## API Documentation`.
-
-2. **Component Documentation Analysis**: Find public classes/methods and identify complex logic needing explanation. Document under `## Component Documentation`.
-
-3. **Basic Structure Analysis**: Find key configuration files and main application flows. Document under `## Structure Documentation`.
-
-### PHASE 1B: SYSTEMATIC FILE ANALYSIS FOR DOCUMENTATION
-
-**IMPORTANT: MUST DO WITH TODO LIST**
-
-For each file, document in `## Knowledge Graph`:
-
-- Standard fields plus documentation-specific:
-- `documentationGaps`: Missing or incomplete documentation
-- `complexityLevel`: How difficult to understand (1-10)
-- `userFacingFeatures`: Features needing user documentation
-- `developerNotes`: Technical details needing developer docs
-- `exampleRequirements`: Code examples or usage scenarios needed
-- `apiDocumentationNeeds`: API endpoints requiring documentation
-- `configurationOptions`: Configuration parameters needing explanation
-- `troubleshootingAreas`: Common issues requiring troubleshooting docs
-
-### PHASE 1C: OVERALL ANALYSIS
-
-Write comprehensive summary showing:
-
-- Complete end-to-end workflows discovered
-- Documentation gaps identified
-- Priority areas for documentation
-
----
-
-## PHASE 2: DOCUMENTATION PLAN GENERATION
-
-Generate detailed documentation plan under `## Documentation Plan`:
-
-- Focus on completeness
-- Ensure clarity
-- Include examples
-- Maintain consistency
-
----
-
-## PHASE 3: APPROVAL GATE
-
-**CRITICAL**: Present documentation plan for explicit approval. **DO NOT** proceed without it.
-
----
-
-## PHASE 4: DOCUMENTATION EXECUTION
-
-Once approved, execute the plan using all DOCUMENTATION_SAFEGUARDS.
-
----
-
-## SUCCESS VALIDATION
-
-Verify documentation is:
-
-- Accurate (matches actual code)
-- Complete (covers all public APIs)
-- Helpful (includes examples)
-
-Document under `## Documentation Validation`.
-
----
-
-## Documentation Guidelines
-
-- **Accuracy-first approach**: Verify every documented feature with actual code
-- **User-focused content**: Organize documentation based on user needs
-- **Example-driven documentation**: Include practical examples and usage scenarios
-- **Consistency maintenance**: Follow established documentation patterns
-- **No assumptions**: Always verify behavior before documenting

package/templates/skills/domain-name-brainstormer/SKILL.md

@@ -1,212 +0,0 @@
----
-name: domain-name-brainstormer
-description: Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.
----
-
-# Domain Name Brainstormer
-
-This skill helps you find the perfect domain name for your project by generating creative options and checking what's actually available to register.
-
-## When to Use This Skill
-
-- Starting a new project or company
-- Launching a product or service
-- Creating a personal brand or portfolio site
-- Rebranding an existing project
-- Registering a domain for a side project
-- Finding available alternatives when your first choice is taken
-
-## What This Skill Does
-
-1. **Understands Your Project**: Analyzes what you're building and who it's for
-2. **Generates Creative Names**: Creates relevant, memorable domain options
-3. **Checks Availability**: Verifies which domains are actually available across multiple TLDs
-4. **Multiple Extensions**: Suggests .com, .io, .dev, .ai, .app, and more
-5. **Provides Alternatives**: Offers variations if top choices are taken
-6. **Branding Insights**: Explains why certain names work well
-
-## How to Use
-
-### Basic Brainstorming
-
-```
-I'm building a project management tool for remote teams. 
-Suggest domain names.
-```
-
-```
-Help me brainstorm domain names for a personal finance app
-```
-
-### Specific Preferences
-
-```
-I need a domain name for my AI writing assistant. 
-Prefer short names with .ai or .io extension.
-```
-
-### With Keywords
-
-```
-Suggest domain names using the words "pixel" or "studio" 
-for my design agency
-```
-
-## Example
-
-**User**: "I'm building a tool for developers to share code snippets. Suggest creative domain names."
-
-**Output**:
-```
-Analyzing your project...
-Target audience: Developers
-Key features: Code sharing, snippets, collaboration
-
-🎯 Domain Name Suggestions
-
-## Available (.com)
-1. ✓ snippetbox.com - Clear, memorable, available!
-   Why: Directly describes the product, easy to remember
-
-2. ✓ codeclip.com - Short and snappy
-   Why: Implies quick code sharing, only 8 characters
-
-3. ✓ devpaste.com - Developer-focused
-   Why: Familiar to devs (like pastebin), clear purpose
-
-## Available (Alternative TLDs)
-4. ✓ snippet.dev - Perfect extension for developers
-   Why: .dev extension signals developer tool
-
-5. ✓ codebox.io - Tech-forward
-   Why: .io popular with tech startups, clean name
-
-6. ✓ sharecode.app - Descriptive
-   Why: .app extension, clearly states the action
-
-## Premium/Taken (.com)
-- codeshare.com (Taken, est. $2,500)
-- snippets.com (Taken, premium domain)
-
-## Recommendations
-
-🏆 Top Pick: snippet.dev
-- Perfect for developer audience
-- Short and memorable  
-- .dev extension adds credibility
-- Available now!
-
-🥈 Runner-up: snippetbox.com
-- .com is universally recognized
-- Slightly longer but descriptive
-- Great brandability
-
-Next steps:
-1. Register your favorite before someone else does!
-2. Want me to check more variations?
-3. Need help with logo ideas for these names?
-```
-
-**Inspired by:** Ben Aiad's use case from Lenny's Newsletter
-
-## Domain Naming Tips
-
-### What Makes a Good Domain
-
-✓ **Short**: Under 15 characters ideal
-✓ **Memorable**: Easy to recall and spell
-✓ **Pronounceable**: Can be said in conversation
-✓ **Descriptive**: Hints at what you do
-✓ **Brandable**: Unique enough to stand out
-✓ **No hyphens**: Easier to share verbally
-
-### TLD Guide
-
-- **.com**: Universal, trusted, great for businesses
-- **.io**: Tech startups, developer tools
-- **.dev**: Developer-focused products
-- **.ai**: AI/ML products
-- **.app**: Mobile or web applications
-- **.co**: Alternative to .com
-- **.xyz**: Modern, creative projects
-- **.design**: Creative/design agencies
-- **.tech**: Technology companies
-
-## Advanced Features
-
-### Check Similar Variations
-
-```
-Check availability for "codebase" and similar variations 
-across .com, .io, .dev
-```
-
-### Industry-Specific
-
-```
-Suggest domain names for a sustainable fashion brand, 
-checking .eco and .fashion TLDs
-```
-
-### Multilingual Options
-
-```
-Brainstorm domain names in English and Spanish for 
-a language learning app
-```
-
-### Competitor Analysis
-
-```
-Show me domain patterns used by successful project 
-management tools, then suggest similar available ones
-```
-
-## Example Workflows
-
-### Startup Launch
-1. Describe your startup idea
-2. Get 10-15 domain suggestions across TLDs
-3. Review availability and pricing
-4. Pick top 3 favorites
-5. Register immediately
-
-### Personal Brand
-1. Share your name and profession
-2. Get variations (firstname.com, firstnamelastname.dev, etc.)
-3. Check social media handle availability too
-4. Register consistent brand across platforms
-
-### Product Naming
-1. Describe product and target market
-2. Get creative, brandable names
-3. Check trademark conflicts
-4. Verify domain and social availability
-5. Test names with target audience
-
-## Tips for Success
-
-1. **Act Fast**: Good domains get taken quickly
-2. **Register Variations**: Get .com and .io to protect brand
-3. **Avoid Numbers**: Hard to communicate verbally
-4. **Check Social Media**: Make sure @username is available too
-5. **Say It Out Loud**: Test if it's easy to pronounce
-6. **Check Trademarks**: Ensure no legal conflicts
-7. **Think Long-term**: Will it still make sense in 5 years?
-
-## Pricing Context
-
-When suggesting domains, I'll note:
-- Standard domains: ~$10-15/year
-- Premium TLDs (.io, .ai): ~$30-50/year
-- Taken domains: Market price if listed
-- Premium domains: $hundreds to $thousands
-
-## Related Tools
-
-After picking a domain:
-- Check logo design options
-- Verify social media handles
-- Research trademark availability
-- Plan brand identity colors/fonts
-