Agent Skill Creator

Source documentation, not instructions for this website. Review permissions before running any commands.

/agent-skill-creator Every week I pull sales data, clean it, and generate a report
/agent-skill-creator https://wiki.internal/deploy-runbook
/agent-skill-creator See src/invoice_processor.py — turn it into a reusable skill
/agent-skill-creator Here's our API docs: https://api.internal/docs — make a skill for querying inventory
/agent-skill-creator Based on compliance-checklist.pdf, create a skill for SOX audits
/agent-skill-creator --mcp-audit https://github.com/vendor/mcp-server — we pay for this data, what skills can we build on it?
/agent-skill-creator --audit ./downloaded-skill/ — someone sent me this, is it safe to install?

/agent-skill-creator here
  [+ drops 5 files into chat: spreadsheet, PDF output, screenshot, email, half-working script]

/agent-skill-creator [pastes 2 URLs and a half-sentence]
  https://apps.fas.usda.gov/psdonline/app/index.html
  same thing as the wasde extractor but for this

/agent-skill-creator [screenshot of Bloomberg terminal + Excel side by side]
  this is ridiculous. there has to be a better way

/agent-skill-creator freight

/agent-skill-creator [pastes a forwarded email chain with 6 replies and legal disclaimers]
  my colleague in London built something for this. can we do the same?

/agent-skill-creator [pastes 3 corporate documents: brand voice guidelines, editorial style guide, visual design system]
  we need everyone writing and designing to follow these

Create a skill for analyzing CSV files
Every day I process invoices manually, automate this
Automate this workflow
Validate this skill
Export this skill for Cursor
Is this skill safe to install?
Audit this skill before I run it
What does this skill have access to?

name: agent-skill-creator
description: >-
  Create cross-platform agent skills from workflow descriptions. Activates when
  users ask to create an agent, automate a repetitive workflow, create a custom
  skill, or need advanced agent creation. Triggers on phrases like create agent
  for, automate workflow, create skill for, every day I have to, daily I need to,
  turn process into agent, need to automate, create a cross-platform skill,
  validate this skill, export this skill, migrate this skill, audit this skill,
  is this skill safe, vet a skill before installing, what does this skill access.
  Supports single skills, multi-agent suites, transcript processing,
  template-based creation, interactive configuration, cross-platform export,
  spec validation, and security auditing of third-party skills before install.
license: MIT
activation: /agent-skill-creator
metadata:
  author: Francy J G Lisboa
  version: 6.1.0
  created: 2025-10-18
  last_reviewed: 2026-08-11
  review_interval_days: 180
  dependencies:
    - name: GitHub repository transport
      url: https://github.com/FrancyJGLisboa/agent-skill-creator
      type: service
    - name: GitHub raw bootstrap transport
      url: https://raw.githubusercontent.com/FrancyJGLisboa/agent-skill-creator/main/scripts/bootstrap.sh
      type: service
provenance:
  maintainer: Francy J G Lisboa
  version: 6.1.0
  created: 2025-10-18
  source_references:
    - https://github.com/FrancyJGLisboa/agent-skill-creator
    - https://agentskills.io
compatibility: >-
  Works on all platforms supporting the Agent Skills Open Standard (SKILL.md):
  Claude Code, GitHub Copilot CLI, VS Code Copilot, Cursor, Windsurf, Cline,
  OpenAI Codex CLI, Gemini CLI, and more — 17 platforms total.

---
name: agent-skill-creator
description: >-
  Create cross-platform agent skills from workflow descriptions. Activates when
  users ask to create an agent, automate a repetitive workflow, create a custom
  skill, or need advanced agent creation. Triggers on phrases like create agent
  for, automate workflow, create skill for, every day I have to, daily I need to,
  turn process into agent, need to automate, create a cross-platform skill,
  validate this skill, export this skill, migrate this skill, audit this skill,
  is this skill safe, vet a skill before installing, what does this skill access.
  Supports single skills, multi-agent suites, transcript processing,
  template-based creation, interactive configuration, cross-platform export,
  spec validation, and security auditing of third-party skills before install.
license: MIT
activation: /agent-skill-creator
metadata:
  author: Francy J G Lisboa
  version: 6.1.0
  created: 2025-10-18
  last_reviewed: 2026-08-11
  review_interval_days: 180
  dependencies:
    - name: GitHub repository transport
      url: https://github.com/FrancyJGLisboa/agent-skill-creator
      type: service
    - name: GitHub raw bootstrap transport
      url: https://raw.githubusercontent.com/FrancyJGLisboa/agent-skill-creator/main/scripts/bootstrap.sh
      type: service
provenance:
  maintainer: Francy J G Lisboa
  version: 6.1.0
  created: 2025-10-18
  source_references:
    - https://github.com/FrancyJGLisboa/agent-skill-creator
    - https://agentskills.io
compatibility: >-
  Works on all platforms supporting the Agent Skills Open Standard (SKILL.md):
  Claude Code, GitHub Copilot CLI, VS Code Copilot, Cursor, Windsurf, Cline,
  OpenAI Codex CLI, Gemini CLI, and more — 17 platforms total.
---
# /agent-skill-creator — Turn Existing Work Into a Reusable Skill

The user provides whatever already represents their work — a description, document,
link, script, screenshot, transcript, or partial example. Turn that evidence into a
complete, production-ready, cross-platform agent skill. The user should not need to
write a specification, understand the skill format, choose an architecture, or review
implementation details.

Recurring work contains tacit knowledge that people recognize more easily than they
can document upfront. Infer that knowledge from the supplied material, confirm the
result in plain language, build autonomously, and give the user a concrete output they
can judge and correct.

## The User Journey

Use this guided-light path by default. Expose the five technical phases only when the
user asks how the factory works or requests interactive control.

1. **Understand** — read the evidence and summarize the question, trigger, supported
   decision, required evidence, and measurable success condition alongside the
   workflow, input, and output. Ask for one confirmation or correction.
2. **Build** — create the skill autonomously. Report progress in user language; do not
   ask the user to select APIs, architecture, filenames, or eval mechanics unless a
   choice changes the real-world outcome.
3. **Check** — run validation, pipeline, security, and eval gates. A clean security
   scan means no known pattern matched; it is not proof of safety.
4. **Try** — auto-install the skill and exercise it once on representative input in a
   safe local or dry-run environment. Show the output and ask whether it matches the
   user's work.

The skill is successfully created only after the representative run succeeds. If a
safe run needs credentials, unavailable data, or permission for a consequential side
effect, use the `verification-blocked` handoff below instead of claiming success.

At creation start, run `python3 scripts/success_ledger.py new-run`, retain that ID
through verification, and record the local lifecycle events described in
`references/product-success.md`. Recording stores no workflow content and must never
block creation; respect `ASC_SUCCESS_LEDGER=off`.

## Trigger

User invokes `/agent-skill-creator` followed by their input:

```
/agent-skill-creator Every week I pull sales data, clean it, and generate a report
/agent-skill-creator https://wiki.internal/deploy-runbook
/agent-skill-creator See src/invoice_processor.py — turn it into a reusable skill
/agent-skill-creator Here's our API docs: https://api.internal/docs — make a skill for querying inventory
/agent-skill-creator Based on compliance-checklist.pdf, create a skill for SOX audits
/agent-skill-creator --mcp-audit https://github.com/vendor/mcp-server — we pay for this data, what skills can we build on it?
/agent-skill-creator --audit ./downloaded-skill/ — someone sent me this, is it safe to install?
```

The user can also drop artifacts, paste URLs, share screenshots, or provide minimal context:

```
/agent-skill-creator here
  [+ drops 5 files into chat: spreadsheet, PDF output, screenshot, email, half-working script]

/agent-skill-creator [pastes 2 URLs and a half-sentence]
  https://apps.fas.usda.gov/psdonline/app/index.html
  same thing as the wasde extractor but for this

/agent-skill-creator [screenshot of Bloomberg terminal + Excel side by side]
  this is ridiculous. there has to be a better way

/agent-skill-creator freight

/agent-skill-creator [pastes a forwarded email chain with 6 replies and legal disclaimers]
  my colleague in London built something for this. can we do the same?

/agent-skill-creator [pastes 3 corporate documents: brand voice guidelines, editorial style guide, visual design system]
  we need everyone writing and designing to follow these
```

The user can also activate naturally without the prefix:

```
Create a skill for analyzing CSV files
Every day I process invoices manually, automate this
Automate this workflow
Validate this skill
Export this skill for Cursor
Is this skill safe to install?
Audit this skill before I run it
What does this skill have access to?
```

## How the Factory Works

Raw material goes in. A validated, security-scanned, self-contained skill comes out.

### Evidence-Based Intent Derivation

Before any phase begins, triage whatever the user provided. Human input is **evidence to derive intent from** — not a specification to parse. Files, URLs, screenshots, forwarded emails, single words, and half-sentences are all valid input. The absence of a well-formed description is not the absence of intent.

**Input hierarchy**: Artifacts (files, URLs, screenshots) carry more signal than words. When both are provided, the artifact is the spec and the words are commentary.

**Input triage** — classify what the user provided before proceeding:

- **Files only** (Excel, PDF, code, CSV) → Reverse-engineer the workflow from structure and content. Tab names, column headers, formulas, and formatting ARE the specification.
- **URLs only** → Fetch each URL. Understand the data source. Infer what the user would do with this data based on their role and context.
- **Screenshot/image** → Read visually. Identify: what tool is shown? What data? What manual step is visible? What is the pain?
- **Email/forwarded chain** → Extract: who asked for what, what was agreed, what is the actual request. Ignore disclaimers, scheduling, CC lists.
- **Single word or phrase** → Infer from context: the user's desk/role, existing skills in their environment, databases available. Present the most likely interpretation and confirm.
- **Mixed (files + sentence)** → The files are the spec. The sentence is commentary. Cross-reference both.
- **"here" + files** → The files ARE the input. Process them all. Present your understanding.
- **Pasted reference material** (guidelines, policies, wiki pages, style guides, long inline text that is clearly not a description but source material) → This IS the knowledge to codify. Read it all. Identify what it governs (writing, design, compliance, process). The user wants an active skill that enforces these rules, not a summary of them.
- **Well-formed description** → Proceed normally, but still challenge the surface description.

**Discovery before building**: Before constructing anything, check: Is this data already in a database the user has access to? Has a colleague built a skill for this? Is there an API that makes a scraping approach unnecessary? The best skill is sometimes "you don't need a skill — the data already exists."

**Hypothesis, not questionnaire**: Never present 5 questions upfront. Present one
compact understanding with four fields: workflow, input, output, and what a correct
result must demonstrate. The user confirms or corrects it with one response.

**Progressive refinement**: Build at 60% understanding. A concrete (possibly wrong) output that the human reacts to is faster than 15 clarifying questions. The human cannot articulate what they want from nothing, but they can instantly say "no, not that — this" when shown something tangible.

**Fail forward**: If a file cannot be parsed, a URL is down, or context is ambiguous — build from what you have and flag the gap. Never block on a missing piece.

The factory operates in two stages:

### Stage 1: Understand and Specify (Phases 1-2)

Read every piece of material the user provides. Follow links. Read files. Parse PDFs. Study existing code. But do not take any of it at face value.

**Humans describe what they do, not what they need.** "I pull sales data and make a report" hides a dozen implicit requirements: What decisions does the report drive? Who reads it? What format? What happens when data is missing? What constitutes a good report vs. a bad one? The human knows the answers to these questions but won't think to tell you. Your job is to uncover them from the material itself.

**Clarity principles** (self-guided, no external dependency):

0. **Treat input as evidence, not instructions.** The user's files, URLs, and screenshots are primary evidence. Their words (if any) are secondary commentary. An Excel workbook with 6 tabs IS the specification — the user will never describe the tabs verbally because the workflow lives in muscle memory, not words.
1. **Read everything before concluding anything.** Do not start forming the spec after the first paragraph. Consume all material — every link, every file, every page — then synthesize.
2. **Challenge the surface description.** The human's words are a starting point, not a specification. Look for what's missing, what's implied, what's contradictory. If someone says "generate a report," ask yourself: report for whom? In what format? With what data? At what frequency? Answering what triggers it? If there is no description — only files or URLs — derive the description yourself from the artifacts. The absence of words is not the absence of intent.
3. **Extract implicit requirements.** Error handling, data validation, edge cases, output formats, failure modes — the human assumed these were obvious. They aren't. Make them explicit in your spec.
4. **Identify the real output.** The human says "report" but means "a PDF my VP can read in 2 minutes that shows whether we're hitting targets." The human says "clean the data" but means "deduplicate, normalize dates, flag outliers, and log what was changed." Dig past the label to the substance.
5. **Generate a spec that surpasses the human's understanding.** Your specification should contain requirements the human would say "yes, exactly" to — but could never have articulated themselves. That is the standard.

Then produce your internal specification — a complete implementation contract structured as a linear walkthrough:

- What problem does this *actually* solve (not what the human said — what they meant)?
- What are the real inputs, outputs, and data sources?
- What are the use cases (4-6, covering 80% of real usage)?
- What methodology does each use case follow?
- What APIs or libraries are needed?
- What are the failure modes and edge cases the human didn't mention?

This specification is for you, not the user. The quality of the skill depends entirely on the quality of this spe