Skip to content
cccskills
FreePublished on GitHub

codexkit-process-mapper

Map existing business processes using BPMN 2.0 notation or simplified swimlane diagrams. Identify waste, handoffs, decision points, and improvement opportunities using Lean principles (8 Wastes). Use when documenting workflows for SOP creation, automation assessment, or process improvement. Do not use for software architecture diagrams — use architecture tools instead.

The English summary is being prepared. Showing the original description.

See how to install

Files included (5)

  • SKILL.md4.7 KB
  • agents/openai.yaml160 B
  • examples/common-mistakes.md738 B
  • examples/good-output.md733 B
  • verification/checklist.md1.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Process Mapper

Purpose

Document and analyze business processes to find waste, reduce cycle time, and identify automation or improvement opportunities.

When to use

  • mapping an existing process for documentation (SOP creation)
  • analyzing a process for waste or bottleneck elimination
  • preparing for process automation — need to map "as-is" before designing "to-be"
  • onboarding new team members who need to understand workflows

When not to use

  • software system architecture (use engineering architecture tools)
  • strategic planning or roadmapping
  • one-time checklists with no recurring flow

Inputs

  • process name and scope (start trigger, end event)
  • stakeholders involved (roles, departments)
  • current steps and their sequence (rough list is fine)
  • known pain points, bottlenecks, or complaints
  • approximate time per step (if known)
  • any existing documentation or SOPs

Procedure

  1. Define scope: specify the start trigger, end event, and boundaries.
  2. Map "as-is" process in swimlane format:
    • Rows = roles or departments (who does what)
    • Columns = process phases
    • Symbols: Rounded Rectangle = Activity, Diamond = Decision, Arrow = Flow, Circle = Start/End
  3. Document each step:
    • Step name (action verb + object)
    • Owner (role, not person name)
    • Estimated time
    • Input and output artifacts
    • Systems or tools used
  4. Identify the 8 Lean Wastes (DOWNTIME):
    • Defects: errors requiring rework
    • Overproduction: doing more than needed
    • Waiting: idle time between steps
    • Non-utilized talent: underusing people's skills
    • Transportation: unnecessary movement of information or work
    • Inventory: work piling up between steps (WIP)
    • Motion: unnecessary steps or clicks
    • Extra processing: over-engineering, gold-plating
  5. Calculate process metrics:
    • Total cycle time (start to end)
    • Value-added time vs. non-value-added time
    • Process efficiency = Value-added time / Total cycle time × 100%
    • Number of handoffs between roles
  6. Recommend improvements (prioritized by impact vs. effort):
    • Eliminate: remove waste steps
    • Automate: replace manual steps with tools
    • Simplify: reduce decision points or approvals
    • Parallelize: run independent steps concurrently

Output

  • process map (swimlane or BPMN 2.0 text notation)
  • step detail table: Step | Owner | Time | Input | Output | Tool | Waste Type
  • process metrics summary (cycle time, efficiency, handoff count)
  • waste identification with DOWNTIME categorization
  • improvement recommendations prioritized by impact/effort

Definition of done

  • process is mapped from start trigger to end event
  • every step has an owner, estimated time, and input/output
  • waste identification covers all 8 Lean waste types
  • at least 3 improvement recommendations with prioritization

Examples

  • "Map our employee onboarding process from offer acceptance to first productive day."
  • "Document the invoice processing workflow and find where delays happen."
  • "We want to automate our customer support escalation — map the as-is process first."

Quality Criteria

  • Steps are executable in sequence without external context
  • Decision points have clear if/then branching
  • Rollback or abort procedures are documented for risky steps
  • Expected duration or time-per-step is estimated

Verification (4C)

CheckQuestion
CorrectnessDo the steps execute correctly in the order specified?
CompletenessAre decision points, error handling, and escalation paths all documented?
Context-fitCould someone with the right access but no prior context complete this runbook?
ConsequenceIf Step N fails and the operator skips to Step N+1, what breaks?

Edge Cases

  • Steps require access the operator doesn't have — Document exact access requirements upfront. Include escalation contact for emergency access.
  • Environment differs from documented state — Add a pre-flight check as Step 0 to verify prerequisites before starting.
  • Runbook is triggered during off-hours — Document who to contact and which steps can be safely deferred to business hours.

Changelog

  • v1.0.0 — Initial release

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Design rigorous A/B test plans with hypothesis, sample size calculation, Minimum Detectable Effect (MDE), randomization strategy, and decision rules. Includes guardrail metrics and rollout playbook. Use when planning product experiments, conversion optimization, or data-driven feature decisions.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Review REST and GraphQL API designs for consistency, usability, and best practices. Covers naming conventions, versioning strategy, error format, pagination, authentication patterns, and breaking change detection. Use when reviewing API specs, designing new APIs, or auditing existing endpoints.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Write Architecture Decision Records (ADRs) following the Michael Nygard format. Captures context, options considered, decision rationale, and consequences. Use when making technology choices, framework selections, or any architectural decision that future developers need to understand.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Assess organizational readiness for financial audits (internal or external). Map assertions to account balances, check evidence completeness, score readiness using a Red/Amber/Green framework, and generate a remediation timeline. Aligned with SOX, IFRS, and GAAP audit standards. Use before scheduled audits or when preparing for first-time compliance.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Design safe recurring Codex automations with clear prompts, outputs, schedules, and gating rules.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Refine Product Backlog Items to meet INVEST criteria. Write User Stories with Acceptance Criteria in Given/When/Then format, estimate with Story Points, and flag dependencies. Use before sprint planning when backlog items need grooming. Do not use to prioritize the backlog — that is the Product Owner's decision.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

See all skills by hoavdc

Report a problem with this skill