Agent skill

Skill Architecture Patterns

by BingHanOfUESTC in BingHanOfUESTC/open_agent_team

A skill your agent uses when designing the structure of a new agent skill, choosing skill name, folder layout, freedom level, references/scripts/assets split, dependencies, validation plan, and…

MITAuto-check passedAgent Workflows

Install Skill Architecture Patterns

skills CLI
$ npx skills add BingHanOfUESTC/open_agent_team --skill skill-architecture-patterns -a claude-code

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

GitHub CLI
$ gh skill install BingHanOfUESTC/open_agent_team skill-architecture-patterns --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/BingHanOfUESTC/open_agent_team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/teams/skill_creator_team/skills/skill-architecture-patterns .claude/skills/skill-architecture-patterns && 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-architecture-patterns
GitHub stars
106
Token cost
~317 tokens
SKILL.md length
32 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when designing the structure of a new agent skill, choosing skill name, folder layout, freedom level, references/scripts/assets split, dependencies, validation plan, and…

  • Designing the structure of a new agent skill
  • SKILL.md covers Naming, Freedom Level, File Structure and Architecture Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Choosing skill name

What it does

Skill Architecture Patterns is an agent skill from BingHanOfUESTC/open_agent_team. Use this skill when designing the structure of a new agent skill, choosing skill name, folder layout, freedom level, references/scripts/assets split, dependencies, validation plan, and gotchas before writing SKILL.md.

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

It sits in Agent Workflows, covering Software architecture and Skill authoring. The repository describes itself as: Build persistent multi-agent teams that collaborate like real organizations to deliver complex tasks. The licence is MIT.

When your agent uses it

  • Designing the structure of a new agent skill
  • Choosing skill name
  • References/scripts/assets split
  • Validation plan

Example prompts

  • “/skill-architecture-patterns”

What it can do on your machine

Read from SKILL.md and the folder at commit 7e28736. 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 (its code samples are markdown).

    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

Skill Architecture Patterns loads about 317 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 32 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
~317

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 BingHanOfUESTC/open_agent_team at commit 7e28736, republished under its MIT licence (© BingHanOfUESTC). 32 words, ~317 tokens.

Download SKILL.mdSave it as .claude/skills/skill-architecture-patterns/SKILL.md (or your agent's skills folder).
name
skill-architecture-patterns
description
Use this skill when designing the structure of a new agent skill, choosing skill name, folder layout, freedom level, references/scripts/assets split, dependencies, validation plan, and gotchas before writing SKILL.md.

Skill Architecture Patterns

Naming

Use lowercase hyphen-case. Prefer action or capability names:

text
good: pptx-deck-generation
good: api-change-review
bad: SkillForMakingBeautifulOutputs

Freedom Level

text
High freedom: heuristic workflows, writing, research, broad review.
Medium freedom: preferred patterns with configurable steps.
Low freedom: fragile operations, file formats, APIs, scripts, compliance checks.

File Structure

text
skill-name/
  SKILL.md
  references/     optional: long docs, schemas, examples
  scripts/        optional: deterministic or repeated operations
  assets/         optional: templates, images, starter files

Do not add README, changelog, install guide, or unrelated docs inside a skill package.

Architecture Output

markdown
# Skill Architecture

## Skill Name
## Description Draft
## Freedom Level
## Folder Structure
## SKILL.md Contents
## References
## Scripts
## Assets
## Validation Cases
## Gotchas

© BingHanOfUESTC, 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 teams/skill_creator_team/skills/skill-architecture-patterns of BingHanOfUESTC/open_agent_team.

Open the folder on GitHubat commit 7e28736

Compare with similar skills

Skill Architecture Patterns 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 Architecture Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Architecture Patterns this skillBingHanOfUESTC/open_agent_team106—~317Automated safety check: PassMIT
Project Guidelines Exampleaffaan-m/ECC276k—~2kAutomated safety check: NotesMIT
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0
SkillAnything Skill GeneratorAgentSkillOS/SkillAnything471—~1.9kAutomated safety check: PassMIT
LubanLearnPrompt/luban-skill958—~3.1kAutomated safety check: PassMIT
Crush Builtin Skillscharmbracelet/crush29k—~466Automated safety check: PassCustom licence

Similar skills

  • Project-specific skill template covering architecture, patterns, testing, and deployment guidance.

    276k GitHub stars~2k tokensUpdated 4 days ago
    Testing & QAAuto-check: notes
  • 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
  • SkillAnything Skill Generator

    AgentSkillOS/SkillAnything

    Generates a complete agent skill for a target tool, API, library or workflow through a seven-phase pipeline that ends with testing, tuning and packaging for several platforms.

    471 GitHub stars~1.9k tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check passed
  • Luban

    LearnPrompt/luban-skill

    鲁班(Luban)——Skill打磨工坊。把一个"能用的Skill"打磨成"能被理解、能被安装、能被传播、能被验证、能持续进化"的公共Skill资产。

    958 GitHub stars~3.1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Crush Builtin Skills

    charmbracelet/crush

    Explains how the Crush coding agent embeds builtin skills in its binary and how to add or edit one, including the discovery test and build commands.

    29k GitHub stars~466 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Build Cs Skill

    codestable/CodeStable

    CodeStable skill authoring and evolution protocol. An agent skill from codestable/CodeStable.

    1.1k GitHub stars~3k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from BingHanOfUESTC/open_agent_team

All 30 skills in this repo
  • Skill Validation And Evaluation

    BingHanOfUESTC/open_agent_team

    A skill your agent uses when validating a newly created or updated agent skill with structure checks, routing positive and negative examples, contamination checks, progressive disclosure review, and…

    106 GitHub stars~303 tokensUpdated 3 mo ago
    Auto-check passed
  • Autoresearch Orchestration

    BingHanOfUESTC/open_agent_team

    A skill your agent uses when autoresearchteam needs to manage an end-to-end research lifecycle from Boss brief to literature, idea, implementation, experiments, synthesis, and LaTeX delivery.

    106 GitHub stars~691 tokensUpdated 3 mo ago
    Auto-check passed
  • Experiment Iteration Loop

    BingHanOfUESTC/open_agent_team

    A skill your agent uses when designing, running, logging, diagnosing, or iterating experiments for the selected research idea.

    106 GitHub stars~446 tokensUpdated 3 mo ago
    Auto-check passed
  • Latex Paper Artifact

    BingHanOfUESTC/open_agent_team

    A skill your agent uses when producing the final arXiv-style LaTeX paper, BibTeX, figures, tables, reproducibility statement, appendix, and artifact manifest.

    106 GitHub stars~635 tokensUpdated 3 mo ago
    Auto-check passed
  • Literature Evidence Mapping

    BingHanOfUESTC/open_agent_team

    A skill your agent uses when discovering papers, mapping related work, reading papers deeply, checking citations, or building evidence cards for an auto research task.

    106 GitHub stars~949 tokensUpdated 3 mo ago
    Auto-check passed
  • Media Asset Sourcing

    BingHanOfUESTC/open_agent_team

    A skill your agent uses when PPT slides need external images, screenshots, logos, product photos, stock-like visuals, diagrams, or videos that must be downloaded, inserted, or linked with source and…

    106 GitHub stars~819 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Skill Architecture Patterns

What does Skill Architecture Patterns do?

A skill your agent uses when designing the structure of a new agent skill, choosing skill name, folder layout, freedom level, references/scripts/assets split, dependencies, validation plan, and…. Skill Architecture Patterns is an agent skill from BingHanOfUESTC/open_agent_team.md.

When should I use Skill Architecture Patterns?

Skill Architecture Patterns fits situations like: designing the structure of a new agent skill; choosing skill name; references/scripts/assets split; validation plan.

How do I install Skill Architecture Patterns in Claude Code?

Run `npx skills add BingHanOfUESTC/open_agent_team --skill skill-architecture-patterns -a claude-code`. Or copy the skill folder (teams/skill_creator_team/skills/skill-architecture-patterns in BingHanOfUESTC/open_agent_team) into .claude/skills/skill-architecture-patterns in your project. Claude Code loads it when a task matches its description.

How do I install Skill Architecture Patterns in Codex?

Run `npx skills add BingHanOfUESTC/open_agent_team --skill skill-architecture-patterns -a codex`. Or copy the skill folder (teams/skill_creator_team/skills/skill-architecture-patterns in BingHanOfUESTC/open_agent_team) into .agents/skills/skill-architecture-patterns in your project. Codex loads it when a task matches its description.

Can I use Skill Architecture Patterns 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 BingHanOfUESTC/open_agent_team --skill skill-architecture-patterns -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-architecture-patterns, .gemini/skills/skill-architecture-patterns, .github/skills/skill-architecture-patterns and .opencode/skills/skill-architecture-patterns in your project.

What does Skill Architecture Patterns need to run?

SKILL.md names no scripts, command-line tools or credentials: Skill Architecture Patterns is instructions for the agent only.

Does Skill Architecture Patterns 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 Skill Architecture Patterns 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 Architecture Patterns use?

Skill Architecture Patterns 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 Architecture Patterns use?

About 317 tokens (SKILL.md is roughly 1.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 Architecture Patterns?

Skills that share tags, products or a category with Skill Architecture Patterns: Project Guidelines Example (affaan-m/ECC, 276k stars), Claude Code Plugin Structure (anthropics/claude-plugins-official, 38k stars), SkillAnything Skill Generator (AgentSkillOS/SkillAnything, 471 stars) and Luban (LearnPrompt/luban-skill, 958 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Architecture Patterns?

BingHanOfUESTC (a GitHub user) maintains it in BingHanOfUESTC/open_agent_team, which has 106 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on June 23, 2026.

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