Agent skill

Patterns

by pchalasani in pchalasani/claude-code-tools

Design patterns for the Langroid multi-agent LLM framework. An agent skill from pchalasani/claude-code-tools.

MITAuto-check passedDevelopment

Install Patterns

skills CLI
$ npx skills add pchalasani/claude-code-tools --skill patterns -a claude-code

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

GitHub CLI
$ gh skill install pchalasani/claude-code-tools 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/pchalasani/claude-code-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/langroid/skills/patterns .claude/skills/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
patterns
GitHub stars
2k
Used in
1 other repo
Token cost
~1.2k tokens
SKILL.md length
625 words
Files
8
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Design patterns for the Langroid multi-agent LLM framework. An agent skill from pchalasani/claude-code-tools.

  • Works in 2 steps: Stateful Handler on Agent → Handler with Validation
  • Tasks that involve Design patterns
  • SKILL.md covers Instructions, Agent & Task Basics, Tool Handlers and Task Control, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Patterns is an agent skill from pchalasani/claude-code-tools. Design patterns for the Langroid multi-agent LLM framework. Covers agent configuration, tools, task control, and integrations.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `agent-handler-validation-with-state.md`, `agent-tool-handler-with-state.md` and `done-sequences-specific-tool.md`).

It sits in Development, covering Design patterns. The repository describes itself as: Practical productivity tools for Claude Code, Codex-CLI, and similar CLI coding agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Design patterns

Example prompts

  • “/patterns”

Workflow steps

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

  1. Stateful Handler on Agent
  2. Handler with Validation

What it can do on your machine

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

Patterns loads about 1.2k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 625 words of instructions outside code blocks.

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

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 pchalasani/claude-code-tools at commit 0ca7320, republished under its MIT licence (© pchalasani). 625 words, ~1,170 tokens.

Download SKILL.mdSave it as .claude/skills/patterns/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
patterns
description
Design patterns for the Langroid multi-agent LLM framework. Covers agent configuration, tools, task control, and integrations.

Langroid Patterns

Instructions

Below is an INDEX of design patterns organized by category. Each item describes WHAT you might want to implement, followed by a REFERENCE to a document with a complete code example.

Scan this index to find patterns matching your needs, then consult the corresponding document.


Agent & Task Basics

  1. Task Returns Tool Directly

    Create a Langroid Agent equipped with a single Tool (a ToolMessage), and wrap it in a Task so that running the task returns that ToolMessage directly. Use this pattern when you want a simple LLM agent that returns a structured response.

    • Reference: ./task-return-tool.md

Tool Handlers

  1. Stateful Handler on Agent

    Define a STATEFUL tool handler as a METHOD on the agent (not inside the ToolMessage). Use this pattern when: (a) the tool handler needs to execute external operations (API calls, database queries, file I/O), (b) you need to track state across retries (e.g., failure counter), (c) the handler needs access to agent-level resources (connections, configs), or (d) you want Langroid to automatically loop errors back to the LLM for self-correction. The method name must match the request field of the ToolMessage. Return a string for errors (LLM sees it and can retry), or DoneTool(content=result) to terminate successfully.

    • Reference: ./agent-tool-handler-with-state.md
  2. Handler with Validation

    Validate tool output against agent state before accepting it. Use this pattern when: (a) the LLM's tool output must preserve certain content from the input (e.g., placeholders, required fields), (b) you want automatic retry if validation fails, (c) you need to compare tool output against context the LLM received. Define a handler method on a custom agent class that stores the input context as state, validates the tool output, and returns an error string for retry or AgentDoneTool for success (note: use AgentDoneTool, NOT DoneTool). Use done_sequences=["T[ToolName], A"] so the handler runs before task termination.

    • Reference: ./agent-handler-validation-with-state.md

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

Task Control

  1. Terminate on Specific Tool

    Terminate a Task only when a SPECIFIC tool is called. Use TaskConfig(done_sequences=["T[ToolName]"]) to exit immediately when that tool is emitted, or TaskConfig(done_sequences=["T[ToolName], A"]) to exit after the tool is emitted AND handled by the agent. Use this when an agent has multiple tools but you only want one specific tool to trigger task termination.

    • Reference: ./done-sequences-specific-tool.md
  2. Batch Processing

    Run the SAME task on MULTIPLE inputs concurrently using run_batch_tasks(). Use this pattern when: (a) you need to process many items with the same agent/task logic, (b) you want parallelism without manual asyncio/threading, (c) you need state isolation between items (each gets a cloned agent with fresh message history), (d) you want to avoid connection exhaustion from creating too many agents manually. Each item gets a cloned task+agent, runs independently, results collected in order. Supports batch_size for concurrency limiting.

    • Reference: ./run-batch-tasks.md

Integration & Output

  1. MCP Tools Integration

    Enable a Langroid agent to use MCP (Model Context Protocol) tools from an external MCP server like Claude Code. Use this pattern when: (a) you want your agent to use file editing tools (Read, Edit, Write) from Claude Code, (b) you need to connect to any MCP server via stdio transport, (c) you want to enable ALL tools from an MCP server or just SPECIFIC tools selectively, (d) you want to customize/post-process MCP tool results before returning to the LLM. Uses @mcp_tool decorator for specific tools or get_tools_async() for all tools.

    • Reference: ./mcp-tool-integration.md
  2. Quiet Mode

    Suppress verbose Langroid agent output (streaming, tool JSON, intermediate messages) while showing your own custom progress messages. Use this pattern when: (a) you want clean CLI output showing only milestone events, (b) you're running a multi-step workflow and want to show progress without agent noise, (c) you need thread-safe output control. Use quiet_mode() context manager to wrap agent task.run() calls, then print your own messages outside the context.

    • Reference: ./quiet-mode.md

© pchalasani, MIT. 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 7 other files in plugins/langroid/skills/patterns of pchalasani/claude-code-tools.

  • SKILL.md
  • agent-handler-validation-with-state.md
  • agent-tool-handler-with-state.md
  • done-sequences-specific-tool.md
  • mcp-tool-integration.md
  • quiet-mode.md
  • run-batch-tasks.md
  • task-return-tool.md

Open the folder on GitHubat commit 0ca7320

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in pchalasani/claude-code-tools, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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.

Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Patterns this skillpchalasani/claude-code-tools2k1 repos~1.2kAutomated safety check: PassMIT
Vercel Composition Patternssupabase/supabase111k59 repos~726Automated safety check: PassMIT
Swiftui View RefactorDimillian/Skills4k5 repos~2kAutomated safety check: PassMIT
RTK Rust Design Patternsrtk-ai/rtk83k—~1.9kAutomated safety check: PassApache-2.0
Effect Client WrapperUsefulSoftwareCo/executor4.1k1 repos~1.4kAutomated safety check: PassMIT
Architecture PatternsKartikLabhshetwar/better-shot2.4k2 repos~1.4kAutomated safety check: PassCustom licence

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 59 repos~726 tokens
    DevelopmentAuto-check passed
  • Swiftui View Refactor

    Dimillian/Skills

    Refactor and review SwiftUI view files with strong defaults for small dedicated subviews, MV-over-MVVM data flow, stable view trees, explicit dependency injection, and correct Observation usage.

    4k GitHub starsUsed in 5 repos~2k tokens
    DevelopmentAuto-check passed
  • Describes seven Rust design patterns for the RTK CLI filter modules, with when to use each, RTK examples, and notes on when a pattern is overkill.

    83k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Effect Client Wrapper

    UsefulSoftwareCo/executor

    Pattern for wrapping third-party SDK clients (Stripe, Resend, AWS, etc.) with Effect.

    4.1k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Architecture Patterns

    KartikLabhshetwar/better-shot

    Deep dive into software architecture for macOS. An agent skill from KartikLabhshetwar/better-shot.

    2.4k GitHub starsUsed in 2 repos~1.4k tokens
    DevelopmentAuto-check passed
  • GitVersion .NET Development

    GitTools/GitVersion

    Gives repository-specific .NET guidance for GitVersion: build and test commands, central package management, project layout and coding conventions.

    3.1k GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from pchalasani/claude-code-tools

All 17 skills in this repo
  • Remove AI Patterns

    pchalasani/claude-code-tools

    Remove AI-writing patterns ("AI-isms") from text using the avoid-ai-writing catalog (conorbronsdon/avoid-ai-writing).

    2k GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check passed
  • Dynamic Workflow

    pchalasani/claude-code-tools

    Create, review, run, inspect, pause, resume, and cancel durable JavaScript workflows that coordinate multiple headless Codex agents.

    2k GitHub stars~5.3k tokensUpdated 3 days ago
    Auto-check passed
  • Voxtype Install

    pchalasani/claude-code-tools

    Guide the user through installing, configuring, and launching voxtype — local on-device voice dictation (speech-to-text that types wherever the cursor is).

    2k GitHub stars~857 tokensUpdated 3 days ago
    Auto-check: notes
  • Agent Style

    pchalasani/claude-code-tools

    Literature-backed English technical-prose writing rules (agent-style, 21 rules).

    2k GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check passed
  • Msg

    pchalasani/claude-code-tools

    Inter-agent communication via the msg CLI. An agent skill from pchalasani/claude-code-tools.

    2k GitHub stars~362 tokensUpdated 3 days ago
    Auto-check passed
  • Tmux CLI

    pchalasani/claude-code-tools

    CLI utility to communicate with other CLI Agents or Scripts in other tmux panes; use it only when user asks you to communicate with other CLI Agents or Scripts in other tmux panes.

    2k GitHub stars~324 tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Patterns

What does Patterns do?

Design patterns for the Langroid multi-agent LLM framework. An agent skill from pchalasani/claude-code-tools. Patterns is an agent skill from pchalasani/claude-code-tools. Design patterns for the Langroid multi-agent LLM framework.

When should I use Patterns?

Patterns fits situations like: tasks that involve Design patterns.

How do I install Patterns in Claude Code?

Run `npx skills add pchalasani/claude-code-tools --skill patterns -a claude-code`. Or copy the skill folder (plugins/langroid/skills/patterns in pchalasani/claude-code-tools) into .claude/skills/patterns in your project. Claude Code loads it when a task matches its description.

How do I install Patterns in Codex?

Run `npx skills add pchalasani/claude-code-tools --skill patterns -a codex`. Or copy the skill folder (plugins/langroid/skills/patterns in pchalasani/claude-code-tools) into .agents/skills/patterns in your project. Codex loads it when a task matches its description.

Can I use 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 pchalasani/claude-code-tools --skill 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/patterns, .gemini/skills/patterns, .github/skills/patterns and .opencode/skills/patterns in your project.

What does Patterns need to run?

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

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

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

About 1.2k tokens (SKILL.md is roughly 4.7k 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 Patterns?

Skills that share tags, products or a category with Patterns: Vercel Composition Patterns (supabase/supabase, 111k stars), Swiftui View Refactor (Dimillian/Skills, 4k stars), RTK Rust Design Patterns (rtk-ai/rtk, 83k stars) and Effect Client Wrapper (UsefulSoftwareCo/executor, 4.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Patterns?

pchalasani (a GitHub user) maintains it in pchalasani/claude-code-tools, which has 2,010 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 5, 2026.

Source: pchalasani/claude-code-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.