plugins/handsonai/skills/naming-workflows/SKILL.md
This skill should be used when the user wants to name a workflow, write workflow descriptions, standardize workflow documentation, add a workflow to Notion, or structure workflow entries. Generates consistent, outcome-focused names and descriptions for business workflows and creates entries in the Notion Workflows database.
npx skillsauth add jamesgray-ai/handsonai-plugins naming-workflowsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Generate consistent, professional names and descriptions for business workflows, then create entries in the Notion Workflows database.
Sales workflows:
[Prospect Type] [Action]Marketing workflows:
[Content Type] [Action/Purpose]Product workflows:
[Deliverable] [Action]Education workflows:
[Student/Cohort] [Activity]Consulting workflows:
[Deliverable/Phase] [Action]Operations workflows:
[Function] [Process]Finance workflows:
[Transaction Type] [Action]| If workflow monitors/checks | Use "[Subject] Monitoring" or "[Subject] Review" | | If workflow creates output | Use "[Output] Creation" or "[Output] Generation" | | If workflow sends/distributes | Use "[Item] Distribution" or "[Item] Delivery" | | If workflow onboards/sets up | Use "[Subject] Onboarding" or "[Subject] Setup" | | If workflow recovers/follows up | Use "[Subject] Recovery" or "[Subject] Follow-up" |
❌ Verb phrases: "Managing Email", "Creating Content" ❌ Too generic: "Daily Task", "Process 1" ❌ Too long: "Student Enrollment Payment Processing and Confirmation" ❌ Tool-focused: "Claude Email Tool", "Using Zapier for X" ❌ Jargon without context: "SOP-001", "Flow Alpha"
Write 1-2 concise sentences that answer:
[Action verb] [object] [context/condition]. [Outcome statement].
Good descriptions:
Avoid:
Write a short phrase (2-5 words) naming the concrete business deliverable.
| Workflow | Process Outcome | |----------|-----------------| | Email Response Drafting | Draft email responses | | Lead Qualification | Qualified lead list | | Content Repurposing | 5+ social assets | | Student Onboarding | Onboarded students | | Newsletter Distribution | Published newsletter | | Invoice Generation | Sent invoices |
When naming/describing workflows, consider these Notion properties:
Domain (inherited from Business Process):
Trigger:
Sequence (within Business Process):
| Workflow Name | Description | Process Outcome | |---------------|-------------|-----------------| | Lead Qualification | Identify and score prospects using research tools and qualification criteria. Produces ranked lead list with contact details. | Qualified lead list | | Student Enrollment | Process active student applications through payment and confirmation. Results in enrolled students ready for onboarding. | Enrolled students | | Enrollment Recovery | Re-engage prospects who abandoned the enrollment process. Generates personalized follow-up sequences. | Re-engagement emails |
| Workflow Name | Description | Process Outcome | |---------------|-------------|-----------------| | Content Repurposing | Transform lesson recordings into multi-platform social content. Creates LinkedIn posts, X threads, and Substack excerpts. | 5+ social assets | | Newsletter Distribution | Publish newsletter content and distribute across platforms. Delivers newsletter to subscribers and social channels. | Published newsletter | | Social Media Scheduling | Plan and schedule weekly LinkedIn and X content. Produces content calendar with scheduled posts. | Weekly content calendar |
| Workflow Name | Description | Process Outcome | |---------------|-------------|-----------------| | Lesson Content Creation | Design and write online course lesson materials. Produces slide decks, exercises, and student resources. | Complete lesson package | | Curriculum Design | Structure course outline aligned with learning objectives. Creates module sequence with Bloom's taxonomy alignment. | Course curriculum | | Exercise Development | Create hands-on activities for course participants. Generates practical exercises with solutions and rubrics. | Student exercises |
| Workflow Name | Description | Process Outcome | |---------------|-------------|-----------------| | Student Onboarding | Grant course access and prepare students for Day 1. Delivers welcome materials, Slack access, and technical setup. | Onboarded students | | Live Session Delivery | Teach scheduled scheduled cohort sessions. Facilitates learning, Q&A, and student engagement. | Completed session | | Assessment & Feedback | Review student work and provide constructive feedback. Generates graded assignments with improvement guidance. | Graded assignments |
| Workflow Name | Description | Process Outcome | |---------------|-------------|-----------------| | Email Response Drafting | Review inbox for urgent messages and create draft replies. Produces professionally written responses ready for review. | Draft email responses | | Calendar Management | Coordinate scheduling across meetings and cohort sessions. Maintains organized calendar with buffer time. | Updated calendar | | Slack Response Drafting | Monitor Slack channels and create appropriate replies. Generates context-aware draft responses. | Draft Slack messages |
When user provides a workflow description:
<your-workflows-database-id><your-database-url>Properties:
| Property | Type | Values/Notes |
|----------|------|--------------|
| Name | title | Workflow name (2-4 words) |
| Description | text | 1-2 sentences |
| Process Outcome | text | Concrete deliverable (2-5 words) |
| Business Process | relation | Link to Business Processes database |
| Sequence | number | Order within process (use 10, 20, 30...) |
| Status | select | Backlog, Under Development, In Production |
| Type | select | Augmented, Automated, Manual |
| Trigger | text | e.g., "Weekly (Sunday)", "On email arrival", "Manual" |
| Apps | multi-select | Notion, Web Search, Gmail, Slack, GitHub, etc. |
| SOP | url | Link to SOP markdown file (populated by writing-workflow-sops) |
| Workflow Requirements | url | Link to workflow requirements markdown file (populated by framework Deconstruct phase) |
| Design Spec | url | Link to Design Spec markdown file (populated by framework Design phase) |
| Assets Used | relation | Link to Assets database (optional) |
<your-business-processes-database-id>Domains: Coaching, Consulting, Education, Finance, Marketing, Operations, Product, Sales
After user confirms name, description, and process outcome:
Notion:notion-search with relevant keywordsNotion:notion-create-pages:{
"parent": {"data_source_id": "<your-workflows-database-id>"},
"pages": [{
"properties": {
"Name": "Workflow Name Here",
"Description": "Description here.",
"Process Outcome": "Outcome here",
"Status": "Under Development",
"Type": "Augmented",
"Trigger": "Weekly (Sunday)",
"Sequence": 10,
"Business Process": "[\"https://www.notion.so/<business-process-page-id>\"]"
}
}]
}
Default values:
Name formula: [Subject] [Action/Purpose] (2-4 words, noun phrase)
Description formula: [Action verb] [object] [condition]. [Outcome]. (1-2 sentences)
Process Outcome: Concrete deliverable (not "completed workflow")
Sequence: Multiples of 10 within Business Process (10, 20, 30...)
Business Process: ⚡ Lightning Lesson Launch
| Sequence | Workflow | Trigger | |:--------:|----------|---------| | 10 | Lightning Lesson Design | Ad-hoc (new lesson idea) | | 20 | Lightning Lesson Content Creation | 2-3 weeks before event | | 30 | Lightning Lesson Promotion | 2-3 weeks before event | | 40 | Lightning Lesson Conversion | Post-event (within 48 hours) |
Note: Content Creation (20) and Promotion (30) could share sequence "20" if they run in parallel.
documentation
Write Standard Operating Procedure documentation for workflows and save as markdown files. Selects full or lightweight SOP template based on autonomy level (deterministic vs. guided/autonomous), then adapts for workflow type (Manual, Augmented, Automated). Use when the user asks to write an SOP, document a workflow, create procedure documentation, or capture how a workflow is executed. Triggers on "write an SOP", "document this workflow", "create operating instructions", "how is this workflow executed".
tools
Use when a user has a fuzzy idea they want to explore before writing a formal PRD. Captures the essence of an idea as a Vision Brief — a structured, business-focused artifact that feeds directly into the feature-prd workflow.
documentation
Write Business Process Guide documentation that explains when, why, and how to execute a complete business process with its component workflows, and save as markdown files. Use when documenting a business process end-to-end, creating playbooks, or explaining how multiple workflows fit together. Triggers on "write process guide", "document this process", "create a playbook for", "how do these workflows connect".
tools
Use when starting a new feature, defining requirements before implementation, or when the user says "new feature", "create a spec", "create a PRD", or "feature PRD".