new-sdk-app

new-sdk-app is a command for Claude Code from basher83/lunar-claude. It costs 12 tokens per session (1,923 once invoked), scanned A, original, MIT.

A guided command for creating a new Python application with the Claude Agent SDK, a toolkit for building programs that use Claude as an agent.

In plain words
What is it for?
Starting a Python Claude Agent SDK project, including choosing a project name, checking current documentation, using templates, and validating the result.
Why use it?
It provides a defined setup process, templates, examples, and validation guidance instead of requiring the project structure to be designed from scratch.

Command for Claude Code

Written for Claude Code: argument-hint in frontmatter. Also seen: reads .claude/ paths; mentions subagents; mentions Claude Code.

Part of the python-tools plugin — 3 skills, 3 commands shipped together

Good fit Starting a Python Claude Agent SDK project, including choosing a project name, checking current documentation, using templates, and validating the result.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/basher83/lunar-claude/new-sdk-app
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/basher83/lunar-claude

Made for: Claude Code.

Or install python-tools, the plugin that ships this one along with the rest of its 3 skills, 3 commands.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for new-sdk-app

README.md
[![agentmods](https://agentmods.dev/badge/commands/basher83/lunar-claude/new-sdk-app/github.svg)](https://agentmods.dev/commands/basher83/lunar-claude/new-sdk-app)
Your own site
<a href="https://agentmods.dev/commands/basher83/lunar-claude/new-sdk-app"><img src="https://agentmods.dev/badge/commands/basher83/lunar-claude/new-sdk-app/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for new-sdk-app

Your own site · 80×15
<a href="https://agentmods.dev/commands/basher83/lunar-claude/new-sdk-app"><img src="https://agentmods.dev/badge/commands/basher83/lunar-claude/new-sdk-app.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 12 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,923 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00012 $0.01923
Opus 5 $0.00006 $0.00962
Sonnet 5 $0.00002 $0.00385
Haiku 4.5 $0.00001 $0.00192

Measured 9d ago against content hash 18dd8a440460, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

new-sdk-app scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/devops/python-tools/commands/new-sdk-app.md · 211 lines

How it starts

The opening of the file, as written. The whole thing — 211 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are tasked with helping the user create a new Claude Agent SDK application using Python. Follow these steps carefully:

Reference Documentation

Before starting, use the claude-agent-sdk skill to ensure you follow SDK best practices:

# Load the skill to access patterns and examples
/skill claude-agent-sdk

The skill provides:

  • SDK templates (assets/sdk-template.py)
  • Official examples (examples/)
  • Best practices and patterns (references/)
  • Validation checklist (assets/sdk-validation-checklist.md)

Also reference the official documentation:

IMPORTANT: Always check for and use the latest SDK version (targeting >= 0.1.6).

Gather Requirements

IMPORTANT: Ask these questions one at a time. Wait for the user's response before asking the next question. This makes it easier for the user to respond.

Ask the questions in this order (skip any that the user has already provided via arguments):

  1. Project name (ask first): "What would you like to name your project?"

    • If $ARGUMENTS is provided, use that as the project name and skip this question
    • Wait for response before continuing
  2. Agent type (ask second, but skip if #1 was sufficiently detailed): "What kind of agent are you building? Some examples:

    • Coding agent (SRE, security review, code review)
    • Orchestrator with subagents (multi-agent workflows)
    • Business agent (customer support, content creation)
    • Custom agent (describe your use case)"
    • Wait for response before continuing
  3. Starting point (ask third): "Would you like:

    • A minimal query() example for simple tasks
    • A ClaudeSDKClient example for multi-turn conversations
    • An orchestrator with subagents
    • Start from the SDK template (assets/sdk-template.py)"
    • Wait for response before continuing
  4. Project structure (ask fourth): "What project structure would you prefer:

    • Single-file uv script (self-contained with # /// script header)
    • Standard Python project with pyproject.toml"
    • Wait for response before continuing

Read the full file on GitHub · 211 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 211 lines · 12 tokens per session scan A 18dd8a440460

Subscribe to this mod's changes

new-sdk-app is a command published in the GitHub repository basher83/lunar-claude (23 stars, last pushed today), licensed MIT. It adds 12 tokens to every session and 1,923 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.