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.2 KiB

Engineering Workflow Skills

Automate common software engineering workflows including feature planning, testing, git operations, and code review implementation.

Version: 1.1.0


Skills

1. feature-planning

Activates when you say:

  • "Add user authentication"
  • "Build a dashboard"
  • "Implement X feature"
  • "Plan how to do X"

What it does:

  • Asks clarifying questions about requirements
  • Explores codebase for existing patterns
  • Creates detailed implementation plan
  • Hands off to plan-implementer agent for execution

2. test-fixing

Activates when you say:

  • "Fix the tests"
  • "Tests are failing"
  • "Make the test suite green"

What it does:

  • Runs test suite to identify failures
  • Groups errors by type/cause
  • Fixes issues systematically
  • Verifies all tests pass

3. git-pushing

Activates when you say:

  • "Push these changes"
  • "Commit and push"
  • "Create a PR"

What it does:

  • Stages all changes
  • Generates conventional commit message
  • Pushes to remote
  • Creates pull request (if requested)

4. review-implementing

Activates when you say:

  • "Implement this review feedback"
  • "Address these comments"
  • "Apply review suggestions"

What it does:

  • Parses reviewer feedback
  • Creates todo list for each item
  • Implements changes systematically
  • Verifies all feedback addressed

Agent

plan-implementer

Focused agent for implementing code from detailed plans. Uses Haiku model for cost-effective execution.

Used by: feature-planning skill Purpose: Execute discrete implementation tasks with strict scope adherence


Workflow Example

User: "Add user authentication"
  ↓
feature-planning → creates plan, asks questions
  ↓
plan-implementer → implements each task
  ↓
test-fixing → fixes any test failures
  ↓
git-pushing → commits and pushes changes

Installation

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

{
  "plugins": [
    {
      "name": "engineering-workflow-skills",
      "source": "github:anthropics/claude-skills-marketplace/engineering-workflow-plugin",
      "version": "1.1.0"
    }
  ]
}

Author

mhattingpete