jamesgray-ai
32 verified skills135 total stars
test
Guide structured testing of AI workflow artifacts, evaluate output quality, identify which building blocks need adjustment, and determine readiness for deployment. Use when the user has built workflow artifacts and needs to test them. This is Step 5 (Test) of the AI Workflow Framework.
development6
run
This skill should be used when the user has built and tested workflow artifacts and wants a Run Guide for deploying and operating their AI workflow. It generates a plain-language guide with setup steps, deployment patterns, and sharing instructions — tailored to the user's platform and build path. This is Step 6 (Run) of the AI Workflow Framework.
development6
improve
Evaluate a running AI workflow for quality, relevance, and evolution opportunities. Use when the user wants to review how a deployed workflow is performing, check if it needs tuning, or assess whether it should graduate to a more capable orchestration mechanism. This is Step 7 (Improve) of the AI Workflow Framework.
development6
design
This skill should be used when the user has a Workflow Requirements document and wants to design an AI workflow. It gathers architecture decisions, assesses workflow autonomy level, chooses an orchestration mechanism and involvement mode, classifies steps, maps building blocks, identifies skill candidates, configures agents, and produces a Design Spec for approval. Supports both step-decomposed and outcome-driven Workflow Requirements. This is Step 3 (Design) of the AI Workflow Framework.
development6
writing-feature-prds
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".
tools6
writing-vision-briefs
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.
tools6
registering-building-blocks
This skill should be used when the user wants to register or update AI building blocks (Skills, Agents, Prompts, Context MDs) in the Notion AI Building Blocks database. Triggers after skill creation, agent creation, prompt authoring, context MD updates, or when the user asks to register, add, or track a building block in Notion.
development6
build
This skill should be used when the user has an approved Design Spec and wants to build platform artifacts for their AI workflow. It offers a build path choice, researches integration availability, generates platform-appropriate artifacts (prompts, skills, agents, configs), and writes them to the right locations for the user's platform. This is Step 4 (Build) of the AI Workflow Framework.
development6
writing-workflow-sops
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".
documentation6
naming-workflows
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.
documentation6
deconstruct
This skill should be used when the user wants to deconstruct a workflow, break down a business process, capture requirements for an AI workflow, or define an outcome for an agent system. Step 2 is the PRD for the workflow — it captures what the workflow must do, the rules it must follow, and the edge cases it must handle, in clear requirements language suitable for the Design step or any AI model to consume. Supports two paths: step-decomposed (you know how the work gets done) and outcome-driven (you know what "done" looks like and want an agent system to determine the path). Produces a structured Workflow Requirements document. This is Step 2 of the AI Workflow Framework.
development6
writing-process-guides
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".
documentation6
analyze
This skill should be used when the user wants to analyze AI workflow opportunities, run a workflow audit, find automation candidates, or says "where can AI help". Scans memory and conversation history, interviews the user about their work, then produces a prioritized opportunity report with structured workflow candidates ready for the Deconstruct step. This is Step 1 of the AI Workflow Framework.
tools6
editing-hbr-articles
This skill should be used when the user wants to edit a business article to HBR publication quality, review a draft before publication, improve business writing for executive audiences, or mentions "HBR quality" or "publication ready". Makes prescriptive edits for clarity, structure, evidence quality, and executive voice. Targets feature articles and thought leadership pieces.
testing3
publishing-playbook-updates
Draft and publish curated changelog entries for the Hands-on AI Playbook. Scans git history for meaningful changes, drafts a short blog post, presents it for review, writes the file, and notifies Slack. Use when: (1) James wants to post a playbook update, (2) user says "publish update" or "changelog entry", or (3) user runs /publishing-playbook-updates.
documentation3
registering-building-blocks
This skill should be used when the user wants to register or update AI building blocks (Skills, Agents, Prompts, Context MDs) in the Notion AI Building Blocks database. Triggers after skill creation, agent creation, prompt authoring, context MD updates, or when the user asks to register, add, or track a building block in Notion.
development3
writing-process-guides
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".
documentation3
writing-vision-briefs
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.
tools3
analyze
This skill should be used when the user wants to analyze AI workflow opportunities, run a workflow audit, find automation candidates, or says "where can AI help". Scans memory and conversation history, interviews the user about their work, then produces a prioritized opportunity report with structured workflow candidates ready for the Deconstruct step. This is Step 1 of the Business-First AI Framework.
tools3
test
Guide structured testing of AI workflow artifacts, evaluate output quality, identify which building blocks need adjustment, and determine readiness for deployment. Use when the user has built workflow artifacts and needs to test them. This is Step 5 (Test) of the Business-First AI Framework.
development3
build
This skill should be used when the user has an approved AI Building Block Spec and wants to build platform artifacts for their AI workflow. It offers a build path choice, researches integration availability, generates platform-appropriate artifacts (prompts, skills, agents, configs), This is Step 4 (Build) of the Business-First AI Framework.
development3
deconstruct
This skill should be used when the user wants to deconstruct a workflow, break down a business process, define an outcome for an agent system, or deeply analyze a workflow's steps, decisions, data flows, and failure modes. Interactively decomposes a workflow into a structured Workflow Definition using either the 6-question framework (step-decomposed) or an outcome-driven interview (for autonomous agent systems). This is Step 2 of the Business-First AI Framework.
development3
design
This skill should be used when the user has a Workflow Definition and wants to design an AI workflow. It gathers architecture decisions, assesses workflow autonomy level, chooses an orchestration mechanism and involvement mode, classifies steps, maps building blocks, identifies skill candidates, configures agents, and produces a Building Block Spec for approval. Supports both step-decomposed and outcome-driven Workflow Definitions. This is Step 3 (Design) of the Business-First AI Framework.
development3
drafting-linkedin-posts
Draft a LinkedIn post from selected insights, key points, or a topic brief. Use when the user wants to create a LinkedIn post optimized for professional engagement. Produces a complete post with hook, body, CTA, and suggested hashtags. Works well when chained after extracting-article-insights for content repurposing workflows.
data-ai3
extracting-article-insights
Extract key insights, themes, and quotable points from a source article for content repurposing. Use when the user wants to analyze an article, blog post, newsletter, or report to identify the most compelling points for reuse across channels. Produces a structured list of numbered insights with summaries, source quotes, and relevance tags.
business3
improve
Evaluate a running AI workflow for quality, relevance, and evolution opportunities. Use when the user wants to review how a deployed workflow is performing, check if it needs tuning, or assess whether it should graduate to a more capable orchestration mechanism. This is Step 7 (Improve) of the Business-First AI Framework.
development3
preparing-meeting-briefs
This skill should be used when the user wants to prepare for a meeting, research attendees or companies before a call, or needs talking points for an upcoming conversation. Produces a structured meeting prep brief with attendee profiles, company snapshots, talking points, and suggested questions.
research3
run
This skill should be used when the user has built and tested workflow artifacts and wants a Run Guide for deploying and operating their AI workflow. It generates a plain-language guide with setup steps, deployment patterns, and sharing instructions — tailored to the user's platform and build path. This is Step 6 (Run) of the Business-First AI Framework.
development3
writing-feature-prds
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".
tools3
naming-workflows
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.
documentation3
syncing-skills-to-github
This skill should be used when the user wants to sync skills to GitHub, push skill changes to a remote repository, or back up local skills. Syncs Claude Agent Skills from ~/.claude/skills/ (local) to GitHub repository using git commands. Commits changes, pushes to remote, and updates Notion AI Building Blocks with GitHub URLs.
development3
writing-workflow-sops
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".
documentation3