Agent skill

Simplicity First

by Ascend in Ascend/TransferQueue

Simplicity and traceability gate for all TransferQueue code written, fixed, or reviewed.

Apache-2.0Auto-check passedDevelopment

Install Simplicity First

skills CLI
$ npx skills add Ascend/TransferQueue --skill simplicity-first -a claude-code

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

GitHub CLI
$ gh skill install Ascend/TransferQueue simplicity-first --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/Ascend/TransferQueue.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agent/skills/simplicity-first .claude/skills/simplicity-first && 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
simplicity-first
GitHub stars
160
Token cost
~823 tokens
SKILL.md length
397 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

Simplicity and traceability gate for all TransferQueue code written, fixed, or reviewed.

  • Works in 6 steps: Keep execution paths explicit. Make… → Use the smallest readable change. Delete… → Preserve the control-plane/data-plane… → …
  • Tasks that involve Async programming
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Simplicity First is an agent skill from Ascend/TransferQueue. Simplicity and traceability gate for all TransferQueue code written, fixed, or reviewed. Invoke before changing code or reviewing a diff, especially across public APIs, controller and metadata logic, samplers, storage backends, asynchronous execution, or metrics.

Its SKILL.md is about 820 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 Development, covering Async programming. The repository describes itself as: An asynchronous streaming data management module for efficient post-training. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Async programming

Example prompts

  • “/simplicity-first”

Workflow steps

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

  1. Keep execution paths explicit. Make state transitions, partition and
  2. Use the smallest readable change. Delete redundancy before adding new
  3. Preserve the control-plane/data-plane boundary. Keep metadata and
  4. Avoid thin abstractions. Keep one-off logic inline when it remains clear.
  5. Preserve contracts and capabilities. Keep public KV, client, and
  6. Work from reachable behavior. Prioritize issues reproducible through

What it can do on your machine

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

Simplicity First loads about 823 tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 397 words of instructions outside code blocks.

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

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 Ascend/TransferQueue at commit 7b31c0b, republished under its Apache-2.0 licence (© Ascend). 397 words, ~823 tokens.

Download SKILL.mdSave it as .claude/skills/simplicity-first/SKILL.md (or your agent's skills folder).
name
simplicity-first
description
Simplicity and traceability gate for all TransferQueue code written, fixed, or reviewed. Invoke before changing code or reviewing a diff, especially across public APIs, controller and metadata logic, samplers, storage backends, asynchronous execution, or metrics.

Put simplicity first

Keep code readable in one pass. Make each behavior traceable from a public API or configuration entry through controller, metadata, sampler, and storage logic to its tests and observability. Treat hidden control flow and unnecessary indirection as correctness problems, especially across asynchronous or distributed boundaries.

  1. Keep execution paths explicit. Make state transitions, partition and sample ownership, retry or cleanup behavior, and async boundaries visible at the point where they matter. Avoid clever control flow that obscures which component mutates metadata or moves data.

  2. Use the smallest readable change. Delete redundancy before adding new machinery. Do not add configuration, return fields, or extension points for hypothetical future needs.

  3. Preserve the control-plane/data-plane boundary. Keep metadata and scheduling in the controller layer and payload movement in storage managers, clients, and backends. Do not route payloads through the controller or bind a public API to one backend merely to shorten a local implementation.

  4. Avoid thin abstractions. Keep one-off logic inline when it remains clear. Add a helper or type only when it removes real nontrivial duplication, names an important invariant, or implements an existing interface such as a sampler, storage manager, or storage client.

  5. Preserve contracts and capabilities. Keep public KV, client, and dataloader behavior; metadata and sampler semantics; supported storage backends; async and distributed behavior; metrics; and existing defaults. Simplify implementations without silently narrowing the behavior surface.

  6. Work from reachable behavior. Prioritize issues reproducible through supported APIs, configurations, backends, tutorials, or tests. Still protect internal invariants required for concurrency, cleanup, and data consistency; do not invent fixes for states the system cannot enter.

Show full SKILL.md (128 more words)Show less

Checklist before finishing any change

  • Can a reader trace the change from transfer_queue.interface, TransferQueueClient, or StreamingDataLoader through the controller and storage path to a focused test?
  • Are control-plane metadata and data-plane payload responsibilities still separate?
  • Are partition isolation, production and consumption status, sampler behavior, cleanup, and async failure handling preserved where relevant?
  • Could this diff be half the size? If unsure, make it smaller.
  • Does every new abstraction remove real complexity or implement an existing TransferQueue interface?
  • Does any public API, configuration default, metadata shape, or backend contract change? If so, verify every affected caller and test.
  • Keep comments to concise reasons or invariants; omit run-specific data and internal paths, while retaining useful upstream issue or PR links.
  • One problem = one minimal diff. Do not batch unrelated "improvements".

© Ascend, Apache-2.0. 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 .agent/skills/simplicity-first of Ascend/TransferQueue.

Open the folder on GitHubat commit 7b31c0b

Compare with similar skills

Simplicity First 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.

Simplicity First compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Simplicity First this skillAscend/TransferQueue160—~823Automated safety check: PassApache-2.0
YugabyteDB ASH Instrumentationyugabyte/yugabyte-db11k—~4.5kAutomated safety check: PassCustom licence
Mirage VFS Adapter Authoringstrukto-ai/mirage3.7k—~2.5kAutomated safety check: PassApache-2.0
Golang Patternsantoniopaya22/go-rest-template1729 repos~3.5kAutomated safety check: PassNone
Rust Async Patternsdiodeme/Gold-Band14310 repos~3.1kAutomated safety check: PassAGPL-3.0
Swift Concurrencyhenrypldev/react-native-nitro-mlx1003 repos~3.1kAutomated safety check: PassMIT

Similar skills

  • YugabyteDB ASH Instrumentation

    yugabyte/yugabyte-db

    Procedure for adding or changing YugabyteDB Active Session History wait states in TServer and DocDB C++ code, including the macro to use for sync and async paths.

    11k GitHub stars~4.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Builds or extends a custom Mirage virtual filesystem adapter for an API, database, object store or app data, with a working mount configuration and filesystem tests.

    3.7k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Golang Patterns

    antoniopaya22/go-rest-template

    Idiomatic Go patterns, best practices, and conventions for building robust, efficient, and maintainable Go applications.

    172 GitHub starsUsed in 9 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Rust Async Patterns

    diodeme/Gold-Band

    Master Rust async programming with Tokio, async traits, error handling, and concurrent patterns.

    143 GitHub starsUsed in 10 repos~3.1k tokens
    DevelopmentAuto-check passed
  • Swift Concurrency

    henrypldev/react-native-nitro-mlx

    Diagnose Swift Concurrency issues, refactor callback-based code to async/await, and guide Swift 6 migration when working with tasks, actors, @MainActor, Sendable, data races, thread safety, or…

    100 GitHub starsUsed in 3 repos~3.1k tokens
    DevelopmentAuto-check passed
  • Rust Engineer

    farm-fe/farm

    Writes, reviews, and debugs idiomatic Rust code with memory safety and zero-cost abstractions.

    5.6k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed

Categories

Questions about Simplicity First

What does Simplicity First do?

Simplicity and traceability gate for all TransferQueue code written, fixed, or reviewed. Simplicity First is an agent skill from Ascend/TransferQueue. Simplicity and traceability gate for all TransferQueue code written, fixed, or reviewed.

When should I use Simplicity First?

Simplicity First fits situations like: tasks that involve Async programming.

How do I install Simplicity First in Claude Code?

Run `npx skills add Ascend/TransferQueue --skill simplicity-first -a claude-code`. Or copy the skill folder (.agent/skills/simplicity-first in Ascend/TransferQueue) into .claude/skills/simplicity-first in your project. Claude Code loads it when a task matches its description.

How do I install Simplicity First in Codex?

Run `npx skills add Ascend/TransferQueue --skill simplicity-first -a codex`. Or copy the skill folder (.agent/skills/simplicity-first in Ascend/TransferQueue) into .agents/skills/simplicity-first in your project. Codex loads it when a task matches its description.

Can I use Simplicity First 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 Ascend/TransferQueue --skill simplicity-first -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/simplicity-first, .gemini/skills/simplicity-first, .github/skills/simplicity-first and .opencode/skills/simplicity-first in your project.

What does Simplicity First need to run?

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

Does Simplicity First 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 Simplicity First 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 Simplicity First use?

Simplicity First is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Simplicity First use?

About 823 tokens (SKILL.md is roughly 3.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 Simplicity First?

Skills that share tags, products or a category with Simplicity First: YugabyteDB ASH Instrumentation (yugabyte/yugabyte-db, 11k stars), Mirage VFS Adapter Authoring (strukto-ai/mirage, 3.7k stars), Golang Patterns (antoniopaya22/go-rest-template, 172 stars) and Rust Async Patterns (diodeme/Gold-Band, 143 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Simplicity First?

Ascend (a GitHub organization) maintains it in Ascend/TransferQueue, which has 160 GitHub stars. The repository was last updated on September 24, 2026.

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