Agent skill

Skill Factory

by Szotasz in Szotasz/marveen

Turn any workflow, conversation, or demonstrated process into a reusable SKILL.md.

MITAuto-check passed

Install Skill Factory

skills CLI
$ npx skills add Szotasz/marveen --skill skill-factory -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Szotasz/marveen skill-factory --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Szotasz/marveen.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-factory .claude/skills/skill-factory && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-factory
GitHub stars
117
Token cost
~1.3k tokens
SKILL.md length
540 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Turn any workflow, conversation, or demonstrated process into a reusable SKILL.md.

  • Works in 7 steps: Extract the Workflow → Generalize → Write SKILL.md → …
  • The user says turn this into a skill
  • SKILL.md covers When to Use, Procedure, Pitfalls and Skill Quality Checklist
  • Calls node and bash

What it does

Skill Factory is an agent skill from Szotasz/marveen. Turn any workflow, conversation, or demonstrated process into a reusable SKILL.md. Use when the user says "turn this into a skill", "make a skill from this", "save this workflow", "remember how to do this", or after completing a complex multi-step task that should be repeatable. Also triggers on "tanítsd meg magad", "jegyezd meg ezt a folyamatot", "csinálj ebből skill-t".

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: AI csapatod, ami fut amíg te alszol. The licence is MIT.

When your agent uses it

  • The user says turn this into a skill
  • Make a skill from this
  • Save this workflow
  • Remember how to do this

Example prompts

  • “turn this into a skill”
  • “make a skill from this”
  • “save this workflow”
  • “/skill-factory”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Extract the Workflow
  2. Generalize
  3. Write SKILL.md
  4. Add Supporting Files (if needed)
  5. Run the Linter (required)
  6. Update Skill Index
  7. Validate

What it can do on your machine

Read from SKILL.md and the folder at commit bcd90b2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node
    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • platform.claude.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Factory loads about 1.3k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 540 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Szotasz/marveen at commit bcd90b2, republished under its MIT licence (© Szotasz). 540 words, ~1,329 tokens.

Download SKILL.mdSave it as .claude/skills/skill-factory/SKILL.md (or your agent's skills folder).
name
skill-factory
description
Turn any workflow, conversation, or demonstrated process into a reusable SKILL.md. Use when the user says "turn this into a skill", "make a skill from this", "save this workflow", "remember how to do this", or after completing a complex multi-step task that should be repeatable. Also triggers on "tanítsd meg magad", "jegyezd meg ezt a folyamatot", "csinálj ebből skill-t".

Skill Factory

Convert demonstrated workflows into reusable skills. This is a meta-skill: it creates other skills.

When to Use

  • User explicitly asks to create a skill from a workflow
  • User says "remember how to do this" or "save this process"
  • After a complex task (5+ tool calls) that could be reusable
  • When user corrects your approach and the correction is generalizable
  • Hungarian triggers: "tanítsd meg magad", "csinálj skill-t", "jegyezd meg"

Procedure

Step 1: Extract the Workflow

Analyze the current conversation (or specified workflow) and identify:

  1. Trigger conditions: When should this skill activate?
  2. Input: What does the skill need to start?
  3. Steps: What are the concrete steps (in order)?
  4. Tools used: Which tools/commands were involved?
  5. Decision points: Where did you need to make choices?
  6. Error handling: What went wrong and how was it fixed?
  7. Output: What's the expected result?
Step 2: Generalize

Don't just copy the specific instance. Abstract it:

  • Replace specific file names with [input-file] patterns
  • Replace specific URLs with [target-url] patterns
  • Identify which parts are constant vs. variable
  • Note any prerequisites or dependencies
  • Think about edge cases the original workflow didn't cover
Step 3: Write SKILL.md
bash
SKILL_NAME="[kebab-case-name]"
mkdir -p ~/.claude/skills/$SKILL_NAME

cat > ~/.claude/skills/$SKILL_NAME/SKILL.md << 'EOF'
---
name: [skill-name]
description: [What it does + when to trigger. Be specific and "pushy" -- include multiple trigger phrases so the skill activates when needed.]
---

# [Skill Name]

## When to Use
[List concrete trigger conditions and contexts]

## Prerequisites
[Dependencies, tools, access needed -- skip if none]

## Procedure
1. [First step -- be specific, include commands]
2. [Second step]
...

## Pitfalls
- **[Problem]**: [How to solve it]

## Verification
- [How to confirm the result is correct]

## Examples
**Example 1:**
Input: [what the user said]
Output: [what was produced]
EOF
Step 4: Add Supporting Files (if needed)

If the workflow involves scripts or templates:

bash
mkdir -p ~/.claude/skills/$SKILL_NAME/scripts
mkdir -p ~/.claude/skills/$SKILL_NAME/references
  • scripts/: Executable code for deterministic/repetitive tasks
  • references/: Documentation loaded into context as needed
  • assets/: Templates, icons, or other static files
Step 5: Run the Linter (required)

Check the new or changed skill against Anthropic's "Skill authoring best practices" (https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices):

bash
L=../../scripts/skill-lint.mjs; [ -f "$L" ] || L=scripts/skill-lint.mjs   # sub-agent cwd: agents/<name>/; main agent: the install root
node "$L" ~/.claude/skills/$SKILL_NAME

If it reports a finding (non-zero exit), fix it and run it again until it is clean. The rules it checks:

  • "Keep SKILL.md body under 500 lines for optimal performance" (the body after the frontmatter).
  • "For reference files longer than 100 lines, include a table of contents at the top" (a references/ file over 100 lines).
  • "Keep references one level deep from SKILL.md": every supporting file is linked from SKILL.md itself, not only from another supporting file.
  • Every relative markdown link in SKILL.md points to a file that exists.

The linter only reports; it never rewrites. Do not rewrite a skill installed from an outside source because of it.

Show full SKILL.md (184 more words)Show less
Step 6: Update Skill Index
bash
bash scripts/skill-index.sh
Step 7: Validate

Test the skill mentally:

  • Would the description trigger on a realistic user message?
  • Are the steps clear enough to follow without the original context?
  • Are edge cases covered in Pitfalls?
  • Is the SKILL.md body under 500 lines, and does the linter (Step 5) pass?

Pitfalls

  • Overfitting to one example: Don't just save the exact steps you did. Generalize so it works for similar but different inputs.
  • Too vague descriptions: The description field is the primary trigger. Be specific and include multiple phrasings.
  • Missing error handling: If you hit errors during the original workflow, document them in Pitfalls.
  • Too long: Keep SKILL.md under 500 lines. Move large content to references/ subdirectory.
  • Duplicate skills: Before creating, check ~/.claude/skills/.skill-index.md for existing similar skills. Patch instead of creating a new one.

Skill Quality Checklist

Before finalizing, verify:

  • Description includes multiple trigger phrases
  • Steps are numbered and concrete
  • Commands are copy-pasteable (no pseudocode)
  • Variables are clearly marked with [brackets]
  • Pitfalls section has at least one entry
  • Verification section explains how to confirm success
  • Under 500 lines, and skill-lint reports no finding

© Szotasz, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/skill-factory of Szotasz/marveen.

Open the folder on GitHubat commit bcd90b2

Compare with similar skills

Skill Factory next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Factory compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Factory this skillSzotasz/marveen117—~1.3kAutomated safety check: PassMIT
Factory MCPwarpdotdev/warp65k1 repos~237Automated safety check: PassAGPL-3.0
Modeling Conversion MetricsPostHog/posthog40k—~1.4kAutomated safety check: PassCustom licence
Warp Factory Fileswarpdotdev/warp65k1 repos~2.5kAutomated safety check: PassAGPL-3.0
Factorial AutomationComposioHQ/awesome-claude-skills77k3 repos~738Automated safety check: PassNone
Cost Conversationruvnet/ruflo74k—~407Automated safety check: NotesMIT

Similar skills

  • Factory MCP

    warpdotdev/warp

    Use the Warp Factory MCP to hand work to a software factory and collaborate with it — bundle local work and send it to the cloud, find factory tasks from a Slack thread / Linear ticket /…

    65k GitHub starsUsed in 1 repo~237 tokens
    Agent WorkflowsAuto-check passed
  • Official

    Build reusable conversion models — funnel/step conversion rates, drop-off, and time-to-convert — on either PostHog data-warehouse views (HogQL) or an external dbt project.

    40k GitHub stars~1.4k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Warp Factory Files

    warpdotdev/warp

    Authors and edits file-based Warp software factory definitions rooted at factory.yaml, covering agents, automations, scorers and webhooks, and validates them before a pull request.

    65k GitHub starsUsed in 1 repo~2.5k tokens
    DevelopmentAuto-check passed
  • Factorial Automation

    ComposioHQ/awesome-claude-skills

    Automate Factorial tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~738 tokens
    Productivity & AutomationAuto-check passed
  • Cost Conversation

    ruvnet/ruflo

    Per-conversation cost view — list every session in cost-tracking with started-at, message count, top model, and total cost

    74k GitHub stars~407 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes
  • Conversation Memory

    davila7/claude-code-templates

    Persistent memory systems for LLM conversations including short-term, long-term, and entity-based memory Use when: conversation memory, remember, memory persistence, long-term memory, chat history.

    33k GitHub starsUsed in 4 repos~440 tokens
    Agent WorkflowsAuto-check passed

More from Szotasz/marveen

All 18 skills in this repo
  • Fleet Helper

    Szotasz/marveen

    Shared, dependency-free Python helpers for the agent fleet - dashboard API (memory, messages, kanban), Telegram MarkdownV2 escaping, and rule-based Mail.app triage.

    117 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • GitHub PR Rebase Merge

    Szotasz/marveen

    Merge a stack of GitHub PRs sequentially when they share files and will cause cascading conflicts.

    117 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Handoff

    Szotasz/marveen

    Generate a HANDOFF.md context transfer document for session continuity.

    117 GitHub stars~1.5k tokensUpdated today
    Auto-check: notes
  • Retrospective

    Szotasz/marveen

    Analyze the current session for improvement opportunities in skills, memory, and workflow.

    117 GitHub stars~1.5k tokensUpdated today
    Auto-check: notes
  • A Marveen Bridge és a "Szolgáltatás-lapok" ajánlása és elmagyarázása a gazdának.

    117 GitHub stars~1.4k tokensUpdated today
    Auto-check: warnings
  • Skill Management

    Szotasz/marveen

    List, inspect, patch, or delete skills from ~/.claude/skills/.

    117 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Questions about Skill Factory

What does Skill Factory do?

Turn any workflow, conversation, or demonstrated process into a reusable SKILL.md. Skill Factory is an agent skill from Szotasz/marveen.md.

When should I use Skill Factory?

Skill Factory fits situations like: the user says turn this into a skill; make a skill from this; save this workflow; remember how to do this.

How do I install Skill Factory in Claude Code?

Run `npx skills add Szotasz/marveen --skill skill-factory -a claude-code`. Or copy the skill folder (skills/skill-factory in Szotasz/marveen) into .claude/skills/skill-factory in your project. Claude Code loads it when a task matches its description.

How do I install Skill Factory in Codex?

Run `npx skills add Szotasz/marveen --skill skill-factory -a codex`. Or copy the skill folder (skills/skill-factory in Szotasz/marveen) into .agents/skills/skill-factory in your project. Codex loads it when a task matches its description.

Can I use Skill Factory in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Szotasz/marveen --skill skill-factory -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-factory, .gemini/skills/skill-factory, .github/skills/skill-factory and .opencode/skills/skill-factory in your project.

What does Skill Factory need to run?

Going by SKILL.md and its folder, Skill Factory needs the command-line tools its instructions call (node and bash).

Does Skill Factory access the network?

SKILL.md names 1 domain. As links in the text: platform.claude.com. This is read from the text; nothing was executed.

Is Skill Factory safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Factory use?

Skill Factory is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Factory use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skill Factory?

Skills that share tags, products or a category with Skill Factory: Factory MCP (warpdotdev/warp, 65k stars), Modeling Conversion Metrics (PostHog/posthog, 40k stars), Warp Factory Files (warpdotdev/warp, 65k stars) and Factorial Automation (ComposioHQ/awesome-claude-skills, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Factory?

Szotasz (a GitHub user) maintains it in Szotasz/marveen, which has 117 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 10, 2026.

Source: Szotasz/marveen on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.