Agent skill

Common Workflow Writing

by HoangNguyen0403 in HoangNguyen0403/agent-skills-standard

Rules for writing concise, token-efficient workflow and skill files.

MITAuto-check passedAgent Workflows

Install Common Workflow Writing

skills CLI
$ npx skills add HoangNguyen0403/agent-skills-standard --skill common-workflow-writing -a claude-code

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

GitHub CLI
$ gh skill install HoangNguyen0403/agent-skills-standard common-workflow-writing --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/HoangNguyen0403/agent-skills-standard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/common/common-workflow-writing .claude/skills/common-workflow-writing && 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
common-workflow-writing
GitHub stars
572
Token cost
~668 tokens
SKILL.md length
264 words
Files
2
Skills in repo
211
Repo updated
First seen
Licence
MIT

At a glance

Rules for writing concise, token-efficient workflow and skill files.

  • Editing workflow files
  • SKILL.md covers Priority: P0 (CRITICAL), Core Rules, Size Limits and Workflow Structure (Required…, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • New skill definitions

What it does

Common Workflow Writing is an agent skill from HoangNguyen0403/agent-skills-standard. Rules for writing concise, token-efficient workflow and skill files. Prevents over-building that requires costly optimization passes. Use when creating or editing workflow files, SKILL.md files, or new skill definitions.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `evals/evals.json`).

It sits in Agent Workflows, covering Skill authoring. The repository describes itself as: A collection of Agent Skills Standard and Best Practice for Programming Languages, Frameworks that help our AI Agent follow best practies on frameworks and programming laguages. The licence is MIT.

When your agent uses it

  • Editing workflow files
  • New skill definitions

Example prompts

  • “Use the common-workflow-writing skill to rule for writing concise, token-efficient workflow and skill files”
  • “/common-workflow-writing”

What it can do on your machine

Read from SKILL.md and the folder at commit b529c2d. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Common Workflow Writing loads about 668 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 264 words of instructions outside code blocks.

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

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 HoangNguyen0403/agent-skills-standard at commit b529c2d, republished under its MIT licence (© HoangNguyen0403). 264 words, ~668 tokens.

Download SKILL.mdSave it as .claude/skills/common-workflow-writing/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
common-workflow-writing
description
Rules for writing concise, token-efficient workflow and skill files. Prevents over-building that requires costly optimization passes. Use when creating or editing workflow files, SKILL.md files, or new skill definitions.

Workflow Writing Standard

Priority: P0 (CRITICAL)

Core Rules

  • Templates, not examples: Workflows define structure, not pre-filled data. agent generates data at runtime.
  • No example rows in tables: Include headers + 1 skeleton row only. Never populate with fake data.
  • No prose explanations: If bullet or command achieves same result, delete paragraph.
  • No pre-answered questions: Don't document what agent will output — let it output it.
  • Merge sequential steps: If two steps always happen together, they one step.

Size Limits

File typeLimitIf exceeded
Workflow .md80 linesExtract detail to references/
SKILL.md100 linesExtract examples to references/
Table rows8Extract to references/
Inline code block10 linesExtract to references/

Workflow Structure (Required order)

1. Goal (1 sentence)
2. Steps (imperative verb → command or checklist)
3. Output template (headers only, no pre-filled rows)

Anti-Patterns

  • No verbose step preambles: "Before we start, it's important to understand..." → Delete
  • No pre-filled report rows: | Security | P0 | ✅ PASS | CLIENT_ID moved to env | → Delete
  • No repeated examples: Same concept shown twice in different formats → Keep one
  • No "How to X" sections: step instruction
  • No caution blocks for obvious rules: Reserve > ⚠️ for genuinely non-obvious risks
  • Portable output contracts: Use feature_status, missing evidence, decision needed, and adapter-neutral language; avoid runtime-specific tool names, chat channels, containers, and mount paths in canonical workflows.

Quick Self-Check Before Saving

  • Can agent reconstruct any removed content at runtime from context? If yes → remove it
  • every table row real structure, not example data?
  • there any paragraphs bullet list could replace?
  • Would cutting this in half still give agent enough to act on?

Canonical response anchors

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:

  • 80 lines
  • delete

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

Files

SKILL.md and 1 other file in skills/common/common-workflow-writing of HoangNguyen0403/agent-skills-standard.

  • SKILL.md
  • evals/evals.json

Open the folder on GitHubat commit b529c2d

Compare with similar skills

Common Workflow Writing 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.

Common Workflow Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Common Workflow Writing this skillHoangNguyen0403/agent-skills-standard572—~668Automated safety check: PassMIT
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    67k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from HoangNguyen0403/agent-skills-standard

All 211 skills in this repo
  • Subagent-Driven Development

    HoangNguyen0403/agent-skills-standard

    Runs a multi-task implementation plan by sending each task to a fresh implementer subagent, reviewing it independently, then reviewing the whole branch.

    572 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • draw.io Architecture Diagramming

    HoangNguyen0403/agent-skills-standard

    Draws architecture diagrams as editable draw.io files from a JSON spec, with a fixed house style, one C4 level per diagram and evidence-tagged shapes.

    572 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Android Navigation 3 Guide

    HoangNguyen0403/agent-skills-standard

    Implements and migrates to Jetpack Navigation 3 in Compose: NavDisplay, typed route objects, a state-list back stack, deep links, multiple back stacks and dialog scenes.

    572 GitHub stars~687 tokensUpdated yesterday
    Auto-check passed
  • Angular HttpClient Standards

    HoangNguyen0403/agent-skills-standard

    Sets rules for Angular HTTP code: functional interceptors, typed requests, services that own every call, and httpResource for reactive data loading in Angular 17+.

    572 GitHub stars~652 tokensUpdated yesterday
    Auto-check passed
  • Angular Tooling

    HoangNguyen0403/agent-skills-standard

    Angular CLI usage, code generation, build configuration, and bundle optimization.

    572 GitHub stars~743 tokensUpdated yesterday
    Auto-check passed
  • Common Code Review

    HoangNguyen0403/agent-skills-standard

    Conduct high-quality, persona-driven code reviews. An agent skill from HoangNguyen0403/agent-skills-standard.

    572 GitHub stars~772 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Common Workflow Writing

What does Common Workflow Writing do?

Rules for writing concise, token-efficient workflow and skill files. Common Workflow Writing is an agent skill from HoangNguyen0403/agent-skills-standard. Rules for writing concise, token-efficient workflow and skill files.

When should I use Common Workflow Writing?

Common Workflow Writing fits situations like: editing workflow files; new skill definitions.

How do I install Common Workflow Writing in Claude Code?

Run `npx skills add HoangNguyen0403/agent-skills-standard --skill common-workflow-writing -a claude-code`. Or copy the skill folder (skills/common/common-workflow-writing in HoangNguyen0403/agent-skills-standard) into .claude/skills/common-workflow-writing in your project. Claude Code loads it when a task matches its description.

How do I install Common Workflow Writing in Codex?

Run `npx skills add HoangNguyen0403/agent-skills-standard --skill common-workflow-writing -a codex`. Or copy the skill folder (skills/common/common-workflow-writing in HoangNguyen0403/agent-skills-standard) into .agents/skills/common-workflow-writing in your project. Codex loads it when a task matches its description.

Can I use Common Workflow Writing 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 HoangNguyen0403/agent-skills-standard --skill common-workflow-writing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/common-workflow-writing, .gemini/skills/common-workflow-writing, .github/skills/common-workflow-writing and .opencode/skills/common-workflow-writing in your project.

What does Common Workflow Writing need to run?

SKILL.md names no scripts, command-line tools or credentials: Common Workflow Writing is instructions for the agent only.

Does Common Workflow Writing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Common Workflow Writing 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 Common Workflow Writing use?

Common Workflow Writing 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 Common Workflow Writing use?

About 668 tokens (SKILL.md is roughly 2.7k 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 Common Workflow Writing?

Skills that share tags, products or a category with Common Workflow Writing: Skill Creator (Azure/azqr, 796 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Common Workflow Writing?

HoangNguyen0403 (a GitHub user) maintains it in HoangNguyen0403/agent-skills-standard, which has 572 GitHub stars. The repository holds 211 skills in this directory. The repository was last updated on October 9, 2026.

Source: HoangNguyen0403/agent-skills-standard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.