Files
mhattingpeteandClaude 474d7555b3 Feat/productivity skills plugin (#8)
* improve: enhance skill descriptions for better automatic activation

Improved skill descriptions across both plugins to trigger more reliably
when users make requests without specifying exact keywords or formats.

## Visual Documentation Plugin Skills

All four skills improved to activate regardless of whether users specify HTML:

- **flowchart-creator**: Removed "explicitly" and "in HTML format" restrictions
  Added triggers: "process flows"

- **dashboard-creator**: Removed "explicitly" and "in HTML format" restrictions
  Added triggers: "monitoring interfaces"

- **timeline-creator**: Removed "explicitly" and "in HTML format" restrictions
  Added triggers: "project plans"

- **technical-doc-creator**: Removed "explicitly" and "in HTML format" restrictions
  Added triggers: "API references", "developer documentation"

## Engineering Workflow Plugin Skills

All four skills enhanced with additional natural language triggers:

- **feature-planning**: Removed "requires planning before implementation" (too restrictive)
  Added triggers: "create X feature", "I need X"

- **test-fixing**: Added triggers: "run tests and fix failures", "tests aren't passing"

- **git-pushing**: Added triggers: "push this", "push to github"

- **review-implementing**: Added triggers: "fix review issues", "apply these suggestions"

## Testing Artifacts

Added comprehensive test examples and sample outputs:
- TEST_EXAMPLES.md with detailed test cases for each visual skill
- Sample HTML outputs for flowchart and dashboard skills

## Impact

Skills will now activate more reliably when users make natural requests
without requiring exact phrasing or format specifications. This provides
a better user experience and ensures skills are preferred over Claude's
built-in knowledge.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: add productivity-skills plugin with workflow optimization capabilities

Add new productivity-skills plugin containing 4 skills for analyzing usage patterns,
auditing code quality, bootstrapping projects, and generating documentation:

- conversation-analyzer: Analyzes Claude Code usage patterns and suggests workflow improvements
  - Includes Python analysis script for comprehensive conversation history analysis
  - Identifies patterns, common mistakes, and automation opportunities
- code-auditor: Comprehensive codebase analysis covering architecture, security, performance
- project-bootstrapper: Sets up projects with best practices, tooling, and documentation
- codebase-documenter: Generates comprehensive documentation for codebases

Also includes:
- CLAUDE.md: Development guidelines for building marketplace plugins and skills
- Updated marketplace.json with productivity-skills plugin
- Analysis scripts and tools bundled with conversation-analyzer skill
- Updated .gitignore to exclude local analysis outputs

Plugin follows marketplace conventions with proper structure (SKILL.md files,
.claude-plugin/plugin.json, README.md, scripts/ and references/ directories).

Based on analysis of 900+ Claude Code conversations to identify common workflow
optimization needs and productivity patterns.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: enforce skills-first approach in CLAUDE.md guidelines

Update development guidelines to make skills usage mandatory rather than optional:

- Elevate "Skills first" to #1 priority in working guidelines
- Create dedicated "Critical Working Guidelines" section
- Add explicit rule: "ALWAYS use skills when available"
- Specify concrete examples (git-pushing, feature-planning, test-fixing)
- Emphasize: never implement manually when a skill exists

This ensures consistent skill usage throughout the marketplace development
and reinforces the skills-based workflow for all contributors.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat(git-pushing): add smart_commit.sh script for faster workflow

Add automated script to speed up git-pushing skill execution:

- Auto-stages all changes
- Auto-generates conventional commit messages
  - Determines type (feat/fix/docs/test/chore/refactor) from file patterns
  - Extracts scope from changed files
- Adds Claude Code footer automatically
- Smart push handling (new vs existing branches)
- Colored output for better UX
- Shows PR link for GitHub repos

Updated SKILL.md with:
- Fast Path (recommended) - uses script for speed
- Manual Path (fallback) - step-by-step commands

Speed improvement: 1 command instead of 5+ separate bash calls.

Script location: engineering-workflow-plugin/skills/git-pushing/scripts/smart_commit.sh

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* docs(CLAUDE.md): mandate skill-creator usage for new skills

Add critical guideline requiring use of skill-creator skill when creating new skills:

- Added explicit rule: "Use skill-creator for creating new skills"
- Created "CRITICAL: When creating new skills" section
- Emphasized that manual creation leads to missing files and incorrect structure
- References issue where productivity-skills were created manually without proper structure

This prevents future skills from being created with missing skill.json files,
incorrect directory structure, or other structural issues.

Lesson learned: productivity-skills plugin was created manually and lacks
proper skill structure (missing skill.json files in skill directories).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(productivity-skills): correct plugin structure to follow auto-discovery pattern

Fix productivity-skills plugin to follow correct Claude Code plugin structure:

Structural changes:
- Move all skills into skills/ subdirectory (was at plugin root)
- Remove skills array from plugin.json (skills are auto-discovered)
- plugin.json now contains only metadata (name, version, description, author)

Skills moved:
- conversation-analyzer → skills/conversation-analyzer
- code-auditor → skills/code-auditor
- project-bootstrapper → skills/project-bootstrapper
- codebase-documenter → skills/codebase-documenter

CLAUDE.md updates:
- Document that skills MUST be in skills/ subdirectory
- Clarify that skills, agents, and commands are auto-discovered
- Update plugin.json template to show metadata-only structure
- Remove incorrect examples showing skills/agents arrays in plugin.json

This follows the official Claude Code plugin structure where skills are
automatically discovered from the skills/ directory rather than being
listed in plugin.json.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* chore: Restructure of skills, add readme files

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-10-22 20:41:15 +02:00

2.0 KiB

Productivity Skills Plugin

Workflow optimization skills for analyzing usage patterns, auditing code quality, bootstrapping projects, and generating documentation.

Version: 1.0.0


Skills

1. conversation-analyzer

Activates when you say:

  • "Analyze my conversations"
  • "How can I improve my workflow"
  • "Review my Claude Code history"

What it does:

  • Analyzes conversation history from ~/.claude/history.jsonl
  • Identifies patterns, repetitive tasks, and inefficiencies
  • Provides actionable recommendations

2. code-auditor

Activates when you say:

  • "Audit the code"
  • "Check for security issues"
  • "Review code quality"

What it does:

  • Comprehensive analysis across 6 dimensions: architecture, quality, security, performance, testing, maintainability
  • Generates detailed report with file:line references
  • Prioritizes findings and provides action plan

3. project-bootstrapper

Activates when you say:

  • "Set up a new project"
  • "Bootstrap this project"
  • "Add best practices"

What it does:

  • Sets up directory structure, git, testing, linting, CI/CD
  • Creates documentation (README, CONTRIBUTING)
  • Configures development workflow automation

4. codebase-documenter

Activates when you say:

  • "Explain this codebase"
  • "Document the architecture"
  • "Create developer documentation"

What it does:

  • Explores codebase and documents architecture, components, data flow
  • Creates visual diagrams and includes code examples
  • Generates comprehensive documentation files

Installation

Add to your .claude-plugin/marketplace.json:

{
  "plugins": [
    {
      "name": "productivity-skills-plugin",
      "source": "github:anthropics/claude-skills-marketplace/productivity-skills-plugin",
      "version": "1.0.0"
    }
  ]
}

Integration

Works seamlessly with:

  • engineering-workflow-skills: Plan implementations from audit findings, fix issues, commit changes
  • visual-documentation-skills: Create visual diagrams for documentation

Author

mhattingpete