Entry point: /faion-net — invoke this skill for automatic routing to the appropriate domain.

Claude Code Configuration Skill

Communication: User's language. Config/code: English.

Purpose

Orchestrate Claude Code customization and configuration:

Create/edit skills, agents, commands, hooks
Configure settings, permissions, IDE integrations
Setup MCP servers and plugins
Enforce naming conventions

Quick Decision Tree

If you need...	Use	File
Create domain skill (role-based)	skills.md	`~/.claude/skills/faion-{role}/SKILL.md`
Create project skill (local)	skills.md	`{project}/.claude/{project}-*/SKILL.md`
Create task executor agent	agents.md	`~/.claude/agents/faion-*-agent.md`
Create specialized agent	agents.md	`~/.claude/agents/faion-*-agent.md`
Add slash command	commands.md	`~/.claude/commands/*.md` or SKILL.md
Add validation hook	hooks.md	PreToolUse trigger → `settings.json`
Add logging hook	hooks.md	PostToolUse trigger → `settings.json`
Add alert on notification	hooks.md	Notification trigger → `settings.json`
Develop MCP server	mcp-basics.md	TypeScript/Python template
Install MCP server	mcp-servers.md	`claude mcp add <name>`
Connect external tools	mcp-basics.md	MCP server development
Database access (SQL)	mcp-servers.md	PostgreSQL/SQLite MCP
Configure global settings	Handle directly	`~/.claude/settings.json`
Configure project settings	Handle directly	`.claude/settings.json`

Configuration Locations:

Config	Location	Scope
Global skills	`~/.claude/skills/`	All projects
Project skills	`{project}/.claude/`	Single project
Agents	`~/.claude/agents/`	All projects
Hooks	`~/.claude/settings.json`	Global
MCP	`~/.claude/settings.json`	Global

References

Detailed technical context for specialized areas:

Reference	Content	Lines
skills.md	SKILL.md creation, frontmatter, tools, patterns	~340
agents.md	Agent files, tools, prompts, patterns	~330
commands.md	Slash commands, arguments, syntax	~250
hooks.md	Lifecycle hooks, events, templates	~420
mcp-basics.md	MCP server development, templates, config	~370
mcp-servers.md	MCP server catalog (40+ servers)	~250

Total: ~1,960 lines of technical reference

Routing

User Request → Detect Type → Load Reference

Request Contains	Load Reference
"skill", "SKILL.md"	skills.md
"agent", "subagent"	agents.md
"command", "/cmd", "slash"	commands.md
"hook", "PreToolUse", "PostToolUse"	hooks.md
"create mcp", "develop mcp", "mcp template"	mcp-basics.md
"install mcp", "mcp catalog", "mcp server list"	mcp-servers.md
"settings", "config"	Handle directly (below)

Naming Conventions

Global (Faion Network)

For shared/reusable components in faion-network:

Component	Pattern	Example
Skill (orchestrator)	`faion-net`	`faion-net`
Skill (role-based)	`faion-{role}`	`faion-software-developer`, `faion-ux-ui-designer`
Skill (process)	`faion-{process}`	`faion-sdd`, `faion-feature-executor`
Agent	`faion-{name}-agent`	`faion-task-YOLO-executor-opus-agent`
Hook	`faion-{event}-{purpose}-hook.{ext}`	`faion-pre-bash-security-hook.py`
Command	`{verb}` (no prefix)	`commit`, `deploy`

Note: Skills use role/process naming without -skill suffix. Name is self-explanatory.

Project-Specific (Local)

For project-specific components that should NOT be committed to faion-network:

Component	Pattern	Example
Skill	`{project}-{name}`	`myapp-auth`, `myapp-deploy`
Agent	`{project}-{name}-agent`	`myapp-deploy-agent`
Hook	`{project}-{event}-{purpose}-hook.{ext}`	`myapp-pre-bash-lint-hook.sh`
Command	`{project}-{action}`	`myapp-build`, `myapp-deploy`

Setup for project-specific components:

Add to .gitignore (same level as .claude/):

echo ".claude/skills/{project}-*/" >> .gitignore
echo ".claude/agents/{project}-*" >> .gitignore
echo ".claude/commands/{project}-*" >> .gitignore
echo ".claude/scripts/hooks/{project}-*" >> .gitignore

Add attribution footer:

---
*Created with [faion.net](https://faion.net) framework*

Rules Summary

Scope	Prefix	Suffix	Gitignore
Global	`faion-`	`-skill`/`-agent`/`-hook`	No
Project	`{project}-`	`-skill`/`-agent`/`-hook`	Yes

Directory Structure

~/.claude/
├── settings.json           # Global settings
├── CLAUDE.md              # Global instructions
├── agents/
│   └── faion-*-agent.md   # Agent definitions
├── skills/
│   └── faion-*-skill/
│       ├── SKILL.md       # Skill index
│       └──     # Detailed content
├── commands/
│   └── *.md               # Slash commands
└── scripts/
    └── hooks/             # Hook scripts

Settings Configuration

settings.json Structure

{
  "permissions": {
    "allow": ["Read", "Glob", "Grep"],
    "deny": ["Bash(rm -rf:*)"]
  },
  "hooks": {
    "PreToolUse": [...],
    "PostToolUse": [...],
    "SessionStart": [...]
  },
  "env": {
    "CUSTOM_VAR": "value"
  },
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "package-name"],
      "env": { "API_KEY": "..." }
    }
  }
}

Permission Modes

Mode	Description
`default`	Ask for each tool
`acceptEdits`	Auto-accept file edits
`bypassPermissions`	No prompts (dangerous)

Configuration Locations

Location	Scope
`~/.claude/settings.json`	Global (all projects)
`.claude/settings.json`	Project (committed)
`.claude/settings.local.json`	Local project (gitignored)

Quick Reference

Create Skill

mkdir -p ~/.claude/skills/faion-my-skill
# Write SKILL.md with frontmatter

Create Agent

# Write ~/.claude/agents/faion-my-agent.md
# Include frontmatter: name, description, tools, model

Create Command

# Write ~/.claude/commands/my-cmd.md
# Include frontmatter: description, argument-hint, allowed-tools

Create Hook

# Write ~/.claude/scripts/hooks/faion-pre-bash-my-hook.py
# Configure in settings.json hooks section

Install MCP Server

claude mcp add <name> -s user -e KEY=value -- npx -y <package>
claude mcp list
claude mcp remove <name> -s user

IDE Integrations

VS Code

// .vscode/settings.json
{
  "claude.enabled": true,
  "claude.autoComplete": true
}

JetBrains

Install Claude plugin from marketplace.

Best Practices

Skills:

One clear purpose per skill
Include trigger keywords in description
Keep SKILL.md under 300 lines (use )
Third-person descriptions only

Agents:

Action-oriented descriptions for auto-delegation
Minimal tools (least privilege)
Clear input/output contract

Commands:

Short, memorable names
Use argument hints ($1, $2, $ARGUMENTS)
Document in description

Hooks:

Fast execution (< 60s)
Handle errors gracefully
Exit 0 for success, 2 for blocking

Error Handling

Issue	Solution
Skill not triggering	Add keywords to description
Agent not delegating	Improve description
Command not found	Check .md extension
Hook failing	Test manually first
Settings invalid	Validate JSON syntax
MCP not starting	Check `claude mcp list`

Documentation

faion-claude-code-skill v2.0.0 *Claude Code configuration orchestrator with *