Agent skill

Mas Schema Naming

by AUTO-MAS-Project in AUTO-MAS-Project/AUTO-MAS

Define canonical naming for future backend schema domains. An agent skill from AUTO-MAS-Project/AUTO-MAS.

AGPL-3.0Auto-check passed

Install Mas Schema Naming

skills CLI
$ npx skills add AUTO-MAS-Project/AUTO-MAS --skill mas-schema-naming -a claude-code

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

GitHub CLI
$ gh skill install AUTO-MAS-Project/AUTO-MAS mas-schema-naming --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/AUTO-MAS-Project/AUTO-MAS.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/mas-schema-naming .claude/skills/mas-schema-naming && 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
mas-schema-naming
GitHub stars
711
Token cost
~1k tokens
SKILL.md length
427 words
Files
2
Skills in repo
15
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Define canonical naming for future backend schema domains. An agent skill from AUTO-MAS-Project/AUTO-MAS.

  • Works in 4 steps: Make minimal necessary changes first;… → Align with current code style and… → Avoid over-engineering,… → …
  • Creating new specialized schema models
  • SKILL.md covers Objective, Global Constraints, Apply Workflow and Canonical Structure For New…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mas Schema Naming is an agent skill from AUTO-MAS-Project/AUTO-MAS. Define canonical naming for future backend schema domains. Use when creating new specialized schema models or extending Pydantic contracts in app/models/schema.py, standardizing shared Info/Data/Notify/Run semantics, and avoiding new naming drift without forcing retroactive changes on legacy modules.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It works with Pydantic. The repository describes itself as: 多脚本多配置统一管理与自动化工具 | 轻松管理大量脚本并存储多个用户配置、设计自动化任务流、监看脚本日志,大幅提高自动化代理效率与稳定性!. The licence is AGPL-3.0.

When your agent uses it

  • Creating new specialized schema models
  • Extending Pydantic contracts in app/models/schema.py
  • Standardizing shared Info/Data/Notify/Run semantics
  • Avoiding new naming drift without forcing retroactive changes on legacy modules

Example prompts

  • “/mas-schema-naming”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Make minimal necessary changes first; avoid broad refactors unless explicitly requested.
  2. Align with current code style and existing project conventions in the touched module.
  3. Avoid over-engineering, over-abstraction, and defensive programming that does not match existing code patterns.
  4. Study similar existing implementations deeply before coding and follow established local patterns.

What it can do on your machine

Read from SKILL.md and the folder at commit 699de5a. 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 python).

    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

Mas Schema Naming loads about 1k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 427 words of instructions outside code blocks.

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

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 AUTO-MAS-Project/AUTO-MAS at commit 699de5a, republished under its AGPL-3.0 licence (© AUTO-MAS-Project). 427 words, ~1,039 tokens.

Download SKILL.mdSave it as .claude/skills/mas-schema-naming/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
mas-schema-naming
description
Define canonical naming for future backend schema domains. Use when creating new specialized schema models or extending Pydantic contracts in app/models/schema.py, standardizing shared Info/Data/Notify/Run semantics, and avoiding new naming drift without forcing retroactive changes on legacy modules.

MAS Schema Naming

Objective

Standardize naming for future specialized backend schema implementations.

This skill constrains new domain work by default. It does not require retroactive renaming of existing legacy modules unless explicitly requested.

Global Constraints

Apply these constraints while using this skill.

  1. Make minimal necessary changes first; avoid broad refactors unless explicitly requested.
  2. Align with current code style and existing project conventions in the touched module.
  3. Avoid over-engineering, over-abstraction, and defensive programming that does not match existing code patterns.
  4. Study similar existing implementations deeply before coding and follow established local patterns.

Apply Workflow

  1. Determine whether the field is shared semantic or domain-specific semantic.
  2. For shared semantic, use the canonical name from this skill.
  3. For domain-specific semantic, keep naming local to the domain block.
  4. Keep public config-model field style consistent: PascalCase.
  5. When touching legacy modules, prefer compatibility-first edits and avoid broad rename-only refactors.

Canonical Structure For New Domains

Use this top-level structure for new script/user schema models.

python
class XxxConfig(BaseModel):
    Info: XxxConfig_Info | None
    Run: XxxConfig_Run | None
    Emulator: XxxConfig_Emulator | None  # only if emulator semantics exist


class XxxUserConfig(BaseModel):
    Info: XxxUserConfig_Info | None
    Data: XxxUserConfig_Data | None
    Notify: XxxUserConfig_Notify | None
    # optional domain blocks, e.g. Task/Stage/Game

Shared Naming Matrix

Use these names when semantics are the same.

SemanticCanonical nameBlock
Script display nameNameInfo
Script runtime pathPathInfo
Emulator idIdEmulator
Emulator indexIndexEmulator
Transition strategyTaskTransitionMethodRun
Daily proxy limitProxyTimesLimitRun
Retry limitRunTimesLimitRun
Runtime timeoutRunTimeLimitRun
User display nameNameUser.Info
User idIdUser.Info
User enabled statusStatusUser.Info
Remaining day budgetRemainedDayUser.Info
User noteNotesUser.Info
User tag payloadTagUser.Info
Last proxy dateLastProxyDateUser.Data
Proxy run countProxyTimesUser.Data
Manual-check resultIfPassCheckUser.Data
Notify enabledEnabledUser.Notify
Send statisticIfSendStatisticUser.Notify
Send mailIfSendMailUser.Notify
Mail receiverToAddressUser.Notify
ServerChan enabledIfServerChanUser.Notify
ServerChan keyServerChanKeyUser.Notify
Show full SKILL.md (146 more words)Show less

Boundary For Domain-Specific Names

  1. Keep domain-specific semantics inside dedicated domain blocks.
  2. Do not force shared naming when semantics differ.
  3. Do not add synonym fields for the same semantic in one block.

Drift To Avoid In New Work

  1. Same semantic, different names (Path vs RootPath).
  2. Same semantic, different block placement (Data vs Info).
  3. Same semantic, mixed boolean style in the same block.

Compatibility Rule

When canonicalizing an existing public field:

  1. Keep read compatibility for legacy payloads during migration.
  2. Prefer writing canonical names in new responses.
  3. Remove legacy names only after consumer migration is complete.

PR Checklist

  1. New specialized schema models follow this canonical matrix for shared semantics.
  2. Domain-specific fields stay in domain-specific blocks.
  3. No new synonym names are introduced for existing shared semantics.
  4. Legacy modules are not renamed in bulk unless explicitly in scope.

© AUTO-MAS-Project, AGPL-3.0. 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 .agents/skills/mas-schema-naming of AUTO-MAS-Project/AUTO-MAS.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 699de5a

Compare with similar skills

Mas Schema Naming 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.

Mas Schema Naming compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mas Schema Naming this skillAUTO-MAS-Project/AUTO-MAS711—~1kAutomated safety check: PassAGPL-3.0
Building Pydantic AI Agentsdocling-project/docling69k—~2.8kAutomated safety check: PassMIT
Datachain Knowledgedatachain-ai/datachain2.8k—~3kAutomated safety check: PassApache-2.0
Fastcrudbenavlabs/fastcrud1.6k—~5kAutomated safety check: PassMIT
Building Pydantic AI Agentspydantic/pydantic-ai21k—~8.2kAutomated safety check: PassMIT
Investor Panel Stock Reviewwbh604/UZI-Skill7.1k—~757Automated safety check: PassMIT

Similar skills

  • Building Pydantic AI Agents

    docling-project/docling

    Patterns and tested examples for building agents with Pydantic AI: tools, capabilities, structured output, dependency injection, hooks, YAML specs, streaming and testing.

    69k GitHub stars~2.8k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Datachain Knowledge

    datachain-ai/datachain

    A skill your agent uses whenever datasets, cloud storage buckets, or data pipelines are mentioned — creating, saving, querying, listing, exploring, deleting, or processing data in S3, GCS, Azure…

    2.8k GitHub stars~3k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Fastcrud

    benavlabs/fastcrud

    A skill your agent uses when building or modifying CRUD endpoints with FastCRUD (the fastcrud PyPI package) in a FastAPI project — covers FastCRUD, crudrouter, EndpointCreator, FilterConfig…

    1.6k GitHub stars~5k tokensUpdated 16 days ago
    Backend & APIsAuto-check passed
  • Building Pydantic AI Agents

    pydantic/pydantic-ai

    Official

    Build AI agents with Pydantic AI — tools, capabilities (including on-demand loading), workspaces, structured output, streaming, testing, and multi-agent patterns.

    21k GitHub stars~8.2k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Scores a stock through a panel of well-known investor personas, each applying their own method and returning a structured signal, then tallies the votes.

    7.1k GitHub stars~757 tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Fastapi

    Open-TutorAi/open-tutor-ai-CE

    FastAPI best practices and conventions. An agent skill from Open-TutorAi/open-tutor-ai-CE.

    108 GitHub starsUsed in 2 repos~2.6k tokens
    Backend & APIsAuto-check passed

More from AUTO-MAS-Project/AUTO-MAS

All 15 skills in this repo
  • Mas Game Sign

    AUTO-MAS-Project/AUTO-MAS

    Add, refactor, or review AUTO-MAS game community sign-in (game sign) code, including the provider registry in app/tools/gamesign.py, platform adapters for Skland/Miyoushe/Kuro/Taygedo, credential…

    711 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Mas Code Standards

    AUTO-MAS-Project/AUTO-MAS

    A skill your agent uses when implementing, fixing, refactoring, or reviewing non-generated AUTO-MAS code, or when preparing code-style guidance, comments, docstrings, version notes, or Conventional…

    711 GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Mas Frontend UI

    AUTO-MAS-Project/AUTO-MAS

    A skill your agent uses when working on AUTO-MAS frontend UI, Ant Design Vue components, page layout, forms, tables, modals, drawers, feedback, empty/loading/error states, drag interactions, dark…

    711 GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Mas Script Specialized Adapter

    AUTO-MAS-Project/AUTO-MAS

    Review, add, or refactor AUTO-MAS specialized script adapters by upstream architecture, including MAA, SRC, MaaEnd/MXU, General, ok-script adapters such as Okww and OkNte, multi-engine adapters such…

    711 GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Mas API Contract

    AUTO-MAS-Project/AUTO-MAS

    Define backend API contract standards for FastAPI services. An agent skill from AUTO-MAS-Project/AUTO-MAS.

    711 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Mas Data Model

    AUTO-MAS-Project/AUTO-MAS

    Define backend data modeling standards for Python services. An agent skill from AUTO-MAS-Project/AUTO-MAS.

    711 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

Works with

Questions about Mas Schema Naming

What does Mas Schema Naming do?

Define canonical naming for future backend schema domains. An agent skill from AUTO-MAS-Project/AUTO-MAS. Mas Schema Naming is an agent skill from AUTO-MAS-Project/AUTO-MAS. Define canonical naming for future backend schema domains.

When should I use Mas Schema Naming?

Mas Schema Naming fits situations like: creating new specialized schema models; extending Pydantic contracts in app/models/schema.py; standardizing shared Info/Data/Notify/Run semantics; avoiding new naming drift without forcing retroactive changes on legacy modules.

How do I install Mas Schema Naming in Claude Code?

Run `npx skills add AUTO-MAS-Project/AUTO-MAS --skill mas-schema-naming -a claude-code`. Or copy the skill folder (.agents/skills/mas-schema-naming in AUTO-MAS-Project/AUTO-MAS) into .claude/skills/mas-schema-naming in your project. Claude Code loads it when a task matches its description.

How do I install Mas Schema Naming in Codex?

Run `npx skills add AUTO-MAS-Project/AUTO-MAS --skill mas-schema-naming -a codex`. Or copy the skill folder (.agents/skills/mas-schema-naming in AUTO-MAS-Project/AUTO-MAS) into .agents/skills/mas-schema-naming in your project. Codex loads it when a task matches its description.

Can I use Mas Schema Naming 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 AUTO-MAS-Project/AUTO-MAS --skill mas-schema-naming -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mas-schema-naming, .gemini/skills/mas-schema-naming, .github/skills/mas-schema-naming and .opencode/skills/mas-schema-naming in your project.

What does Mas Schema Naming need to run?

SKILL.md names no scripts, command-line tools or credentials: Mas Schema Naming is instructions for the agent only. Our summary lists: Python 3.

Does Mas Schema Naming 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 Mas Schema Naming 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 Mas Schema Naming use?

Mas Schema Naming is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mas Schema Naming use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Mas Schema Naming?

Skills that share tags, products or a category with Mas Schema Naming: Building Pydantic AI Agents (docling-project/docling, 69k stars), Datachain Knowledge (datachain-ai/datachain, 2.8k stars), Fastcrud (benavlabs/fastcrud, 1.6k stars) and Building Pydantic AI Agents (pydantic/pydantic-ai, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mas Schema Naming?

AUTO-MAS-Project (a GitHub organization) maintains it in AUTO-MAS-Project/AUTO-MAS, which has 711 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 10, 2026.

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