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

...

faion-claude-code

SKILL.md