Agent skill

Adk Style Guide

by BrainDAO in BrainDAO/adk-ts

ADK-TS brand voice, terminology, and writing conventions. An agent skill from BrainDAO/adk-ts.

MITAuto-check passedWriting & Content

Install Adk Style Guide

skills CLI
$ npx skills add BrainDAO/adk-ts --skill adk-style-guide -a claude-code

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

GitHub CLI
$ gh skill install BrainDAO/adk-ts adk-style-guide --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/BrainDAO/adk-ts.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/adk-ts-style-guide .claude/skills/adk-style-guide && 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
adk-style-guide
GitHub stars
119
Token cost
~1.8k tokens
SKILL.md length
593 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

ADK-TS brand voice, terminology, and writing conventions. An agent skill from BrainDAO/adk-ts.

  • Writing any documentation
  • SKILL.md covers Overview, When to Use, Brand Identity & Positioning and Terminology, plus 6 more sections
  • Reaches github.com and t.me
  • Technical content for the ADK-TS project

What it does

Adk Style Guide is an agent skill from BrainDAO/adk-ts. ADK-TS brand voice, terminology, and writing conventions. Use when writing any documentation, READMEs, changelogs, blog posts, or technical content for the ADK-TS project. Also use when reviewing content for brand and style consistency.

Its SKILL.md is about 1.8k 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 Writing & Content, covering Technical documentation, Changelog and release notes and Blog and article writing. It works with TypeScript. The repository describes itself as: A robust framework for building AI agents with multi-provider LLM support. The licence is MIT.

When your agent uses it

  • Writing any documentation
  • Technical content for the ADK-TS project
  • Reviewing content for brand and style consistency

Example prompts

  • “/adk-style-guide”

Requirements

  • Node.js

What it can do on your machine

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

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com
    • t.me
    • adk.iqai.com
    • npmjs.com
    • files.catbox.moe

    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

Adk Style Guide loads about 1.8k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 593 words of instructions outside code blocks.

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

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 BrainDAO/adk-ts at commit f93632d, republished under its MIT licence (© BrainDAO). 593 words, ~1,799 tokens.

Download SKILL.mdSave it as .claude/skills/adk-style-guide/SKILL.md (or your agent's skills folder).
name
adk-style-guide
description
ADK-TS brand voice, terminology, and writing conventions. Use when writing any documentation, READMEs, changelogs, blog posts, or technical content for the ADK-TS project. Also use when reviewing content for brand and style consistency.

ADK-TS Style Guide

Overview

This skill enforces ADK-TS brand identity, terminology, voice, and formatting conventions across all written content in the monorepo. It applies to documentation pages, READMEs, changelogs, code comments, and any developer-facing text.

When to Use

  • Writing or editing any .md or .mdx file in the repo
  • Creating changelogs or release notes
  • Writing code comments or docstrings that reference ADK-TS
  • Reviewing content for consistency

Brand Identity & Positioning

Naming Rules (Critical)
RuleCorrectIncorrect
Framework nameADK-TSADK, adk-ts, ADK TS, Adk-Ts
Never expand the acronymADK-TSAgent Development Kit, Agent Development Kit for TypeScript
CLI referencesADK-TS CLIadk CLI, the CLI, ADK CLI
Package names in code@iqai/adk, @iqai/adk-cliThese are acceptable as-is (they are npm identifiers)
Tagline & Description
  • Tagline: "The TypeScript-Native AI Agent Framework"
  • Short description: "An open-source framework for building production-ready AI agents in TypeScript"
  • People do not need to know what ADK-TS stands for. Just reference it as ADK-TS.
SEO-Aligned Language

Use these terms naturally in content:

  • "TypeScript AI agents"
  • "TypeScript agent framework"
  • "build AI agents in TypeScript"
  • "AI agent orchestration in TypeScript"

Avoid leading with these (they pull into Google's ADK space):

  • "Agent Development Kit"
  • "ADK" alone

Terminology

Always use these exact terms:

Correct TermAvoid
agentbot (unless literally a bot template like Telegram/Discord)
toolfunction (when referring to agent capabilities)
sessionconversation (for the persistence layer)
runnerexecutor (for the agent runner)
MCP serverMCP plugin, MCP integration
AgentBuilderagent builder (lowercase, when referring to the class)
LlmAgentLLM agent (lowercase, when referring to the class)

Voice & Tone

  • Professional but approachable — not stiff, not casual
  • Developer-centric — assume TypeScript fluency
  • Action-oriented — use imperative verbs: "Create", "Install", "Run", "Build"
  • Concise — lead with the answer, skip filler words
  • Encouraging — end sections with "Ready to build?" or "Ready to contribute?"

Formatting Conventions

Headings
  • H1 (#) for page title only — one per file
  • H2 (##) for major sections
  • H3 (###) for subsections
  • Use emoji prefix for README section headings (e.g., ## 🚀 Quick Start)
  • No emoji in docs site MDX headings (Fumadocs handles styling)
Code Blocks
  • Always specify language: ```typescript or ```bash
  • Never use ```js — always ```typescript
Feature Lists

Use this pattern in READMEs:

markdown
- **🤖 Multi-Provider LLM Support** - Seamlessly integrate OpenAI, Anthropic, Google, and other providers
- **🛠️ Extensible Tool System** - Define custom tools with declarative schemas
Show full SKILL.md (240 more words)Show less
Configuration Tables

Use this column structure:

markdown
| Property | Type     | Required | Description              |
| -------- | -------- | -------- | ------------------------ |
| `name`   | `string` | Yes      | The agent's display name |

Code Example Conventions

  • Always TypeScript (never JavaScript)
  • Import from @iqai/adk (never relative paths in documentation)
  • Use AgentBuilder for simple/introductory examples
  • Use new LlmAgent({...}) for advanced configuration examples
  • Include dotenv setup when environment variables are needed
  • Default model: gemini-2.5-flash (Gemini is the default LLM — use it in most examples). Other supported: gpt-4.1, claude-sonnet-4-5
Simple Example Pattern
typescript
import { AgentBuilder } from "@iqai/adk";

const response = await AgentBuilder.withModel("gemini-2.5-flash").ask(
  "What is the primary function of an AI agent?",
);
Advanced Example Pattern
typescript
import { LlmAgent } from "@iqai/adk";

const agent = new LlmAgent({
  name: "my-agent",
  model: "gemini-2.5-flash",
  instruction: "You are a helpful assistant",
  tools: [myTool],
});

Canonical URLs

Use these exact URLs everywhere — no variations:

ResourceURL
GitHub repohttps://github.com/IQAIcom/adk-ts
GitHub Discussionshttps://github.com/IQAIcom/adk-ts/discussions
Telegram (ADK-TS / IQ Builders)https://t.me/+Z37x8uf6DLE3ZTQ8
Telegram (IQ AI company)https://t.me/IQAICOM
Documentation sitehttps://adk.iqai.com/
NPM packagehttps://www.npmjs.com/package/@iqai/adk
Sample projectshttps://github.com/IQAIcom/adk-ts-samples
Logo imagehttps://files.catbox.moe/vumztw.png

Telegram link usage: Use the ADK-TS / IQ Builders link (+Z37x8uf6DLE3ZTQ8) in framework docs, READMEs, and developer-facing content. Use the IQ AI company link (IQAICOM) only for company-level references (e.g., SECURITY.md).

GitHub org casing: Always IQAIcom (NOT IQAICOM or iqaicom)

  • Framework docs: /docs/framework/...
  • CLI docs: /docs/cli/...
  • MCP docs: /docs/mcp-servers/...

Constants

  • Node.js version requirement: >=22.0 (not 18+ — this is the monorepo standard)
  • Package manager: pnpm (always mention pnpm first in multi-manager examples)
  • License: MIT

Checklist for Content Review

When reviewing any content, verify:

  • Uses "ADK-TS" not bare "ADK"
  • Never expands to "Agent Development Kit"
  • CLI referenced as "ADK-TS CLI"
  • GitHub URLs use IQAIcom casing
  • Node.js version is >=22.0
  • Code examples use TypeScript with @iqai/adk imports
  • Model names are current (not deprecated)
  • Canonical URLs are correct
  • Tone is professional but approachable
  • Headings follow hierarchy (H1 → H2 → H3)

© BrainDAO, 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 .claude/skills/adk-ts-style-guide of BrainDAO/adk-ts.

Open the folder on GitHubat commit f93632d

Compare with similar skills

Adk Style Guide 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.

Adk Style Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Adk Style Guide this skillBrainDAO/adk-ts119—~1.8kAutomated safety check: PassMIT
Feature Blogpockethost/pockethost1.4k—~818Automated safety check: PassMIT
Writewaynesutton/markdown-site628—~3kAutomated safety check: PassMIT
Writerrileyhilliard/claude-essentials130—~2kAutomated safety check: PassMIT
Content Writerchrispangg/deepagentsdk128—~3.3kAutomated safety check: PassMIT
Writing Guidelinesrohitg00/pro-workflow2.9k—~593Automated safety check: PassNone

Similar skills

  • Feature Blog

    pockethost/pockethost

    Ship user-facing PocketHost features with a blog post instead of semver release notes.

    1.4k GitHub stars~818 tokensUpdated 11 days ago
    Writing & ContentAuto-check passed
  • Write

    waynesutton/markdown-site

    Writing style guide for technical content, social media, blog posts, READMEs, git commits, and developer documentation.

    628 GitHub stars~3k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Writer

    rileyhilliard/claude-essentials

    Writing style and tone guide for human-sounding content. An agent skill from rileyhilliard/claude-essentials.

    130 GitHub stars~2k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Content Writer

    chrispangg/deepagentsdk

    Writing content across different platforms and styles. An agent skill from chrispangg/deepagentsdk.

    128 GitHub stars~3.3k tokensUpdated 7 mo ago
    Writing & ContentAuto-check passed
  • Writing Guidelines

    rohitg00/pro-workflow

    Apply clear-writing standards to any prose the agent produces - READMEs, docs, UI copy, error messages, commit and PR text, release notes.

    2.9k GitHub stars~593 tokensUpdated 10 days ago
    DevelopmentAuto-check passed
  • Writing Style

    umputun/cc-thingz

    A skill your agent uses for technical communication - GitHub/GitLab tickets, PR/MR descriptions, issue comments, code review comments, commit messages.

    484 GitHub stars~1.3k tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from BrainDAO/adk-ts

  • Adk Docs Writer

    BrainDAO/adk-ts

    ADK-TS documentation specialist for Fumadocs MDX pages. An agent skill from BrainDAO/adk-ts.

    119 GitHub stars~4.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Adk Readme Writer

    BrainDAO/adk-ts

    ADK-TS README specialist. An agent skill from BrainDAO/adk-ts.

    119 GitHub stars~2.6k tokensUpdated 3 mo ago
    Auto-check: notes

Works with

Questions about Adk Style Guide

What does Adk Style Guide do?

ADK-TS brand voice, terminology, and writing conventions. An agent skill from BrainDAO/adk-ts. Adk Style Guide is an agent skill from BrainDAO/adk-ts. ADK-TS brand voice, terminology, and writing conventions.

When should I use Adk Style Guide?

Adk Style Guide fits situations like: writing any documentation; technical content for the ADK-TS project; reviewing content for brand and style consistency.

How do I install Adk Style Guide in Claude Code?

Run `npx skills add BrainDAO/adk-ts --skill adk-style-guide -a claude-code`. Or copy the skill folder (.claude/skills/adk-ts-style-guide in BrainDAO/adk-ts) into .claude/skills/adk-style-guide in your project. Claude Code loads it when a task matches its description.

How do I install Adk Style Guide in Codex?

Run `npx skills add BrainDAO/adk-ts --skill adk-style-guide -a codex`. Or copy the skill folder (.claude/skills/adk-ts-style-guide in BrainDAO/adk-ts) into .agents/skills/adk-style-guide in your project. Codex loads it when a task matches its description.

Can I use Adk Style Guide 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 BrainDAO/adk-ts --skill adk-style-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adk-style-guide, .gemini/skills/adk-style-guide, .github/skills/adk-style-guide and .opencode/skills/adk-style-guide in your project.

What does Adk Style Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Adk Style Guide is instructions for the agent only. Our summary lists: Node.js.

Does Adk Style Guide access the network?

SKILL.md names 5 domains. In commands or code: github.com, t.me, adk.iqai.com, npmjs.com and files.catbox.moe; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Adk Style Guide 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 Adk Style Guide use?

Adk Style Guide 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 Adk Style Guide use?

About 1.8k tokens (SKILL.md is roughly 7.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 Adk Style Guide?

Skills that share tags, products or a category with Adk Style Guide: Feature Blog (pockethost/pockethost, 1.4k stars), Write (waynesutton/markdown-site, 628 stars), Writer (rileyhilliard/claude-essentials, 130 stars) and Content Writer (chrispangg/deepagentsdk, 128 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Adk Style Guide?

BrainDAO (a GitHub organization) maintains it in BrainDAO/adk-ts, which has 119 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on June 26, 2026.

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