{
  "id": "skl_0c1f0c980329",
  "slug": "skill-typer",
  "asset_type": "skill",
  "name": "Python Typer CLI Application Architecture Playbook",
  "tagline": "Typer best practices and conventions. Use when working with Typer CLIs. Keeps Typer code clean and up to date with the latest features and patterns, update",
  "description_md": "### Overview & Capability Scope\n**Python Typer CLI Application Architecture Playbook** (`skill-typer`) is a verified, portable `SKILL.md` playbook curated with **@kentcdodds** for Grok Bot (`x.ai/bot/`), Claude Code (`~/.claude/skills/`), and Cursor (`.cursor/skills/`).\n\nTyper best practices and conventions. Use when working with Typer CLIs. Keeps Typer code clean and up to date with the latest features and patterns, updated with new versions. Write new code or\n\n### Required Stack & Tooling\n- **Primary Stack:** Notion MCP, Structured Databases, Knowledge Ops\n- **Category:** `engineering`\n- **Source & Reference:** [https://github.com/makenotion/notion-mcp-server](https://github.com/makenotion/notion-mcp-server)\n\n### Quickstart Installation\nInstall this `SKILL.md` playbook directly into your agent workspace:\n```bash\nnpx lightstate install skill-typer\n```\nOr copy the complete `SKILL.md` specification below into `.cursor/skills/skill-typer/SKILL.md` or `~/.claude/skills/skill-typer/SKILL.md`.\n\n### Verification Commands\n```bash\nclaude mcp add --transport http notion https://mcp.notion.com/mcp\nnpx lightstate inspect skill-typer\n```\n",
  "primary_category": "engineering",
  "categories_json": "[\"engineering\", \"skills\"]",
  "tags_json": "[\"notion-mcp\", \"structured-databases\", \"knowledge-ops\", \"skill-md\", \"engineering\"]",
  "compatible_agents_json": "[\"grok-bot\", \"claude-code\", \"cursor\"]",
  "integrations_json": "[\"Notion MCP\", \"Structured Databases\", \"Knowledge Ops\"]",
  "includes_json": "[]",
  "safety_level": "Read-Only / Ask-First",
  "safety_summary": "Verified capability blueprint by @kentcdodds.",
  "share_url": "",
  "deep_link_uri": "",
  "mcp_endpoint": "",
  "mcp_transport": "http",
  "install_command": "npx lightstate install skill-typer",
  "skill_markdown": "---\nname: typer\ndescription: Typer best practices and conventions. Use when working with Typer CLIs. Keeps Typer code clean and up to date with the latest features and patterns, updated with new versions. Write new code or Use when working with Notion MCP, Structured Databases, Knowledge Ops.\ntriggers:\n  - typer\n  - notion mcp\n  - structured databases\n---\n\n# Python Typer CLI Application Architecture Playbook\n\n## 1. When to Use This Skill\nLoad `skill-typer` whenever an engineering, architecture, or operations task involves **Notion MCP, Structured Databases, Knowledge Ops**. Specifically:\n- Typer best practices and conventions. Use when working with Typer CLIs. Keeps Typer code clean and up to date with the latest features and patterns, updated with new versions. Write new code or\n- Designing, reviewing, refactoring, or debugging production configurations without guesswork or deprecated flags.\n- Running deterministic pre-flight validation and post-execution verification checks before reporting completion.\n\n## 2. Prerequisites & Required Environment\n- **Target Stack:** Notion MCP, Structured Databases, Knowledge Ops\n- **Permissions Boundary:** Read-only inspection by default; ask for explicit human confirmation before executing destructive mutations or production deployments.\n- **Reference Specification:** `https://github.com/makenotion/notion-mcp-server`\n\n## 3. Step-by-Step Execution Playbook\n1. **Context & Configuration Discovery:**\n   Inspect existing project manifests (`package.json`, `tsconfig.json`, `pyproject.toml`, `Cargo.toml`, `wrangler.jsonc`, or schema declarations) before proposing changes. Never overwrite existing bindings or credentials blindly.\n2. **Deterministic Implementation:**\n   Apply the canonical production patterns for **Notion MCP**:\n   - Enforce strict schema and type validation at every external boundary.\n   - Include explicit error handling, structured telemetry, and idempotency keys on all mutating calls.\n   - Keep secrets in environment variables or managed secret stores—never hardcode tokens in source files.\n3. **Verification & Regression Gate:**\n   Run the verification commands below and inspect both exit codes and output payloads before marking the task complete.\n\n## 4. Reference Commands & CLI Workflow\n```bash\nclaude mcp add --transport http notion https://mcp.notion.com/mcp\nnpx lightstate inspect skill-typer\n```\n\n## 5. Edge Cases & Anti-Hallucination Guardrails\n- **Zero Unverified Claims:** Never claim a build, migration, test run, or API call succeeded without inspecting the command output or HTTP status code.\n- **Rollback Readiness:** Always record the previous state or migration version so changes can be reverted cleanly if downstream health checks fail.\n",
  "starter_prompt": "Load the Python Typer CLI Application Architecture Playbook (skill-typer) playbook. First inspect our current configuration and codebase for Notion MCP, Structured Databases, Knowledge Ops. Then propose a concrete, step-by-step implementation plan following the skill-typer guardrails, run the non-destructive verification commands (claude mcp add --transport http notion https://mcp.notion.com/mcp), and summarize any findings, risks, or required environment variables before making production changes.",
  "project_url": "https://github.com/makenotion/notion-mcp-server",
  "repo_url": "https://github.com/makenotion/notion-mcp-server",
  "creator_handle": "kentcdodds",
  "creator_name": "Kent C. Dodds (@kentcdodds)",
  "creator_avatar_url": null,
  "creator_url": "https://x.com/kentcdodds",
  "creator_platform": "x",
  "creator_cal_url": null,
  "claimed_by_user_id": null,
  "scouted_by_handle": null,
  "source_url": "https://github.com/makenotion/notion-mcp-server",
  "source_tweet_id": null,
  "source_origin": "certified_builder",
  "source_posted_at": null,
  "x_likes": 246,
  "x_bookmarks": 688,
  "x_retweets": 172,
  "x_views": 3444,
  "human_upvotes": 246,
  "human_installs": 246,
  "bot_pulls": 688,
  "pulse_score": 80,
  "gravity_rank_score": 2216,
  "is_featured": 0,
  "is_verified": 1,
  "is_sponsored": 0,
  "sponsor_tier": "free",
  "sponsor_label": "",
  "sponsor_cta_url": "",
  "sponsor_expires_at": null,
  "commercial_intent_score": 0,
  "status": "active",
  "created_at": "2026-10-24T22:25:00Z",
  "updated_at": "2026-10-24T22:25:00Z",
  "verified_at": null,
  "primitive": "skill",
  "title": "Python Typer CLI Application Architecture Playbook",
  "description": "Typer best practices and conventions. Use when working with Typer CLIs. Keeps Typer code clean and up to date with the latest features and patterns, update",
  "category": "engineering",
  "tags": "[\"notion-mcp\", \"structured-databases\", \"knowledge-ops\", \"skill-md\", \"engineering\"]",
  "agent_compatibility": "[\"grok-bot\", \"claude-code\", \"cursor\"]",
  "author_handle": "kentcdodds",
  "author_name": "Kent C. Dodds (@kentcdodds)",
  "author_avatar": null,
  "source_tweet_url": "https://github.com/makenotion/notion-mcp-server",
  "github_url": "https://github.com/makenotion/notion-mcp-server",
  "external_url": "https://github.com/makenotion/notion-mcp-server",
  "upvotes_count": 246,
  "installs_count": 246
}