Agent skill

Authoring Skills

by flutter in flutter/devtools

Guides the creation of high-quality, effective skills for agentic workflows.

BSD-3-ClauseAuto-check passedDevelopment

Install Authoring Skills

skills CLI
$ npx skills add flutter/devtools --skill authoring-skills -a claude-code

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

GitHub CLI
$ gh skill install flutter/devtools authoring-skills --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/flutter/devtools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/authoring-skills .claude/skills/authoring-skills && 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
authoring-skills
GitHub stars
1.7k
Token cost
~449 tokens
SKILL.md length
171 words
Files
3
Skills in repo
10
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Guides the creation of high-quality, effective skills for agentic workflows.

  • Modifying skills in the .agents/skills/ directory
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Authoring Skills is an agent skill from flutter/devtools. Guides the creation of high-quality, effective skills for agentic workflows. Use when creating or modifying skills in the .agents/skills/ directory.

Its SKILL.md is about 450 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `CHECKLIST.md` and `EXAMPLES.md`).

It sits in Development. It works with Flutter. The repository describes itself as: Developer tools for Flutter & Dart. The licence is BSD-3-Clause.

When your agent uses it

  • Modifying skills in the .agents/skills/ directory

Example prompts

  • “Use the authoring-skills skill to guide the creation of high-quality, effective skills for agentic workflows”
  • “/authoring-skills”

What it can do on your machine

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

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

    • antigravity.google
    • platform.claude.com
    • github.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

Authoring Skills loads about 449 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 171 words of instructions outside code blocks.

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

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 flutter/devtools at commit 3a3b64a, republished under its BSD-3-Clause licence (© flutter). 171 words, ~449 tokens.

Download SKILL.mdSave it as .claude/skills/authoring-skills/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
authoring-skills
description
Guides the creation of high-quality, effective skills for agentic workflows. Use when creating or modifying skills in the .agents/skills/ directory.

Authoring Skills

When creating or modifying skills in this repository, follow these best practices:

Repository-Specific Guidelines

  • Location: All skills must be placed in the .agents/skills/ directory.
  • Avoid Duplication: Before creating a skill, check if one already exists in the flutter/skills repository. If it does, do not create a local skill; instead, instruct the user to install it via npx.
  • Naming: Use the gerund form (verb-ing-noun) or noun-phrase (e.g., authoring-skills, adding-release-notes). Use only lowercase letters, numbers, and hyphens.
  • Conciseness: Prioritize brevity in SKILL.md. Agents are already highly capable; only provide context they don't already have.
  • Automation: Any utility scripts placed in the scripts/ directory MUST be written in Dart.
  • Validation: Skills are automatically validated using dart_skills_lint. Ensure your skills pass the linter before submitting. See the README.md in .agents/skills/ for instructions on how to run the linter locally.
  • Progressive Disclosure: Use the patterns below to organize instructions effectively:

© flutter, BSD-3-Clause. 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 2 other files in .agents/skills/authoring-skills of flutter/devtools.

  • SKILL.md
  • CHECKLIST.md
  • EXAMPLES.md

Open the folder on GitHubat commit 3a3b64a

Compare with similar skills

Authoring Skills 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.

Authoring Skills compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Authoring Skills this skillflutter/devtools1.7k—~449Automated safety check: PassBSD-3-Clause
Code Reviewflutter/flutter179k—~1.4kAutomated safety check: PassBSD-3-Clause
Senior Architect Toolkitmaslennikov-ig/claude-code-orchestrator-kit2608 repos~1.2kAutomated safety check: NotesCustom licence
Code Review Skillawesome-skills/code-review-skill2.1k—~2.8kAutomated safety check: NotesMIT
Code Guidelinesgetsentry/sentry-dart873—~2.2kAutomated safety check: PassMIT
Git Worktree Setupk8zdev/k8z155—~930Automated safety check: PassNone

Similar skills

  • Code Review

    flutter/flutter

    Performs a comprehensive, multi-step code review of pull requests or local code changes, using iterative refinement (generation, critique, synthesis) to ensure high-quality, actionable feedback.

    179k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Senior Architect Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive software architecture skill for designing scalable, maintainable systems using ReactJS, NextJS, NodeJS, Express, React Native, Swift, Kotlin…

    260 GitHub starsUsed in 8 repos~1.2k tokens
    DevelopmentAuto-check: notes
  • Code Review Skill

    awesome-skills/code-review-skill

    Provides comprehensive code review guidance for React 19, Vue 3, Angular 17+, Svelte 5, Rust, TypeScript, Java, Java 8, PHP, Ruby, Rails, Python, Django, FastAPI, Go, C/.NET, Kotlin, Swift, Dart…

    2.1k GitHub stars~2.8k tokensUpdated 29 days ago
    DevelopmentAuto-check: notes
  • Code Guidelines

    getsentry/sentry-dart

    Official

    Enforce Sentry Dart/Flutter SDK code guidelines for implementation, refactoring, and review.

    873 GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Automate git worktree creation and copy private files (not tracked in git) to new workdirs.

    155 GitHub stars~930 tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Bump Version

    VeryGoodOpenSource/very_good_analysis

    Bumps the verygoodanalysis package to a new version. An agent skill from VeryGoodOpenSource/very_good_analysis.

    478 GitHub stars~2.6k tokensUpdated 9 days ago
    DevelopmentAuto-check passed

More from flutter/devtools

All 10 skills in this repo
  • Adding Release Notes

    flutter/devtools

    Adds user-facing change descriptions to DevTools release notes.

    1.7k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Adding Copyright Headers

    flutter/devtools

    Adds copyright headers to files based on file type. An agent skill from flutter/devtools.

    1.7k GitHub stars~640 tokensUpdated today
    Auto-check passed
  • Guidelines and step-by-step workflow for debugging DevTools extensions locally, including stub mode, fixed-port launching, browser auto-opening, URL query parameters, target app connection, and…

    1.7k GitHub stars~839 tokensUpdated today
    Auto-check passed
  • Reviewing PRs

    flutter/devtools

    General workflow for fetching, inspecting, reviewing GitHub Pull Requests using the gh CLI, drafting user-aligned review comments, and securing approval before posting.

    1.7k GitHub stars~570 tokensUpdated today
    Auto-check passed
  • Closing Obsolete Issues

    flutter/devtools

    Find and close obsolete, stale, or not reproducible issues in the flutter/devtools repository.

    1.7k GitHub stars~949 tokensUpdated today
    Auto-check passed
  • Reviewing Devtools PRs

    flutter/devtools

    DevTools repository-specific PR review workflow enforcing DevTools style guidelines and common review patterns.

    1.7k GitHub stars~638 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Authoring Skills

What does Authoring Skills do?

Guides the creation of high-quality, effective skills for agentic workflows. Authoring Skills is an agent skill from flutter/devtools. Guides the creation of high-quality, effective skills for agentic workflows.

When should I use Authoring Skills?

Authoring Skills fits situations like: modifying skills in the .agents/skills/ directory.

How do I install Authoring Skills in Claude Code?

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

How do I install Authoring Skills in Codex?

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

Can I use Authoring Skills 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 flutter/devtools --skill authoring-skills -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/authoring-skills, .gemini/skills/authoring-skills, .github/skills/authoring-skills and .opencode/skills/authoring-skills in your project.

What does Authoring Skills need to run?

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

Does Authoring Skills access the network?

SKILL.md names 3 domains. As links in the text: antigravity.google, platform.claude.com and github.com. This is read from the text; nothing was executed.

Is Authoring Skills 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 Authoring Skills use?

Authoring Skills is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Authoring Skills use?

About 449 tokens (SKILL.md is roughly 1.8k 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 Authoring Skills?

Skills that share tags, products or a category with Authoring Skills: Code Review (flutter/flutter, 179k stars), Senior Architect Toolkit (maslennikov-ig/claude-code-orchestrator-kit, 260 stars), Code Review Skill (awesome-skills/code-review-skill, 2.1k stars) and Code Guidelines (getsentry/sentry-dart, 873 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Authoring Skills?

flutter (a GitHub organization) maintains it in flutter/devtools, which has 1,732 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.

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