Can I restrict a subagent's ability to modify files?

Yes, you can use the 'disallowedTools' or 'tools' fields in the YAML frontmatter to explicitly prevent a subagent from using 'Write' or 'Edit' tools.

Where should I store my subagent files?

Subagents can be stored in '.claude/agents/' for project-specific use shared via Git, or in '~/.claude/agents/' for personal use across all projects.

What is a Claude Code subagent?

A subagent is a specialized instance of Claude configured with specific tools, permissions, and system instructions to handle domain-specific tasks autonomously.

What are lifecycle hooks in subagents?

Hooks allow you to run automated commands before or after a tool is used, such as running a linter immediately after a subagent edits a file.

Custom Subagent Architect

Name: Custom Subagent Architect
Author: kkhys

bykkhys

•

Productivity & Workflow

Guides the creation and configuration of specialized Claude subagents with tailored permissions and domain-specific behaviors.

This skill provides a comprehensive framework for building domain-specific subagents within Claude Code, allowing users to delegate specialized tasks like code reviews, debugging, or data analysis to focused AI instances. It streamlines the setup of agent-specific behaviors using YAML frontmatter for tool restrictions, model selection, and permission modes, while leveraging Markdown-based system prompts to define clear operational workflows and lifecycle hooks.

Key Features

01Standardized YAML frontmatter templates for agent metadata

02Lifecycle hook integration for automated pre- and post-tool execution

03Task-specific model aliasing to balance speed and intelligence

041 GitHub stars

05Granular tool restriction management for read-only or edit-capable agents

06Advanced permission mode settings including 'plan' and 'bypassPermissions'

Use Cases

01Building a read-only code reviewer with restricted file-write permissions

02Developing a domain expert for data analysis optimized for SQL and CLI operations

03Creating a specialized debugger with full access to shell and edit tools

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kkhys/claude-code-marketplace creating-subagent

For use in Claude.ai and ChatGPT

Download Skill