Loading...
Loading...
Claude Code: skills, agents, hooks, commands, MCP servers, IDE integrations.
npx skill4agent add faionfaion/faion-network faion-claude-codeEntry point:— invoke this skill for automatic routing to the appropriate domain./faion-net
| Signal | Check For | Why |
|---|---|---|
| Existing skills, naming patterns | Skill framework adoption |
| Agent definitions | Agent usage patterns |
| Hooks, MCP servers, permissions | Configuration maturity |
| Project-specific customizations | Local overrides |
| MCP server logs | Active MCP integrations | Tool ecosystem |
questions:
- question: "What are you configuring?"
options:
- label: "Creating skill"
description: "Use skills.md"
- label: "Creating agent"
description: "Use agents.md"
- label: "Adding command"
description: "Use commands.md"
- label: "Setting up hooks"
description: "Use hooks.md"
- label: "Installing MCP server"
description: "Use mcp-servers.md"
- question: "Is this global or project-specific?"
options:
- label: "Global (all projects)"
description: "Use faion-* prefix, no gitignore"
- label: "Project-specific"
description: "Use {project}-* prefix, add to gitignore"
- question: "Do you have Claude Code experience?"
options:
- label: "Expert user"
description: "Jump to specific reference"
- label: "Some experience"
description: "Use quick reference + examples"
- label: "First time setup"
description: "Start with skills.md basics"| If you need... | Use | File |
|---|---|---|
| Create domain skill (role-based) | skills.md | |
| Create project skill (local) | skills.md | |
| Create task executor agent | agents.md | |
| Create specialized agent | agents.md | |
| Add slash command | commands.md | |
| Add validation hook | hooks.md | PreToolUse trigger → |
| Add logging hook | hooks.md | PostToolUse trigger → |
| Add alert on notification | hooks.md | Notification trigger → |
| Develop MCP server | mcp-basics.md | TypeScript/Python template |
| Install MCP server | mcp-servers.md | |
| Connect external tools | mcp-basics.md | MCP server development |
| Database access (SQL) | mcp-servers.md | PostgreSQL/SQLite MCP |
| Configure global settings | Handle directly | |
| Configure project settings | Handle directly | |
| Config | Location | Scope |
|---|---|---|
| Global skills | | All projects |
| Project skills | | Single project |
| Agents | | All projects |
| Hooks | | Global |
| MCP | | Global |
| 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 |
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) |
| Component | Pattern | Example |
|---|---|---|
| Skill (orchestrator) | | |
| Skill (role-based) | | |
| Skill (process) | | |
| Agent | | |
| Hook | | |
| Command | | |
-skill| Component | Pattern | Example |
|---|---|---|
| Skill | | |
| Agent | | |
| Hook | | |
| Command | | |
echo ".claude/skills/{project}-*/" >> .gitignore
echo ".claude/agents/{project}-*" >> .gitignore
echo ".claude/commands/{project}-*" >> .gitignore
echo ".claude/scripts/hooks/{project}-*" >> .gitignore---
*Created with [faion.net](https://faion.net) framework*| Scope | Prefix | Suffix | Gitignore |
|---|---|---|---|
| Global | | | No |
| Project | | | Yes |
~/.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{
"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": "..." }
}
}
}| Mode | Description |
|---|---|
| Ask for each tool |
| Auto-accept file edits |
| No prompts (dangerous) |
| Location | Scope |
|---|---|
| Global (all projects) |
| Project (committed) |
| Local project (gitignored) |
mkdir -p ~/.claude/skills/faion-my-skill
# Write SKILL.md with frontmatter# Write ~/.claude/agents/faion-my-agent.md
# Include frontmatter: name, description, tools, model# Write ~/.claude/commands/my-cmd.md
# Include frontmatter: description, argument-hint, allowed-tools# Write ~/.claude/scripts/hooks/faion-pre-bash-my-hook.py
# Configure in settings.json hooks sectionclaude mcp add <name> -s user -e KEY=value -- npx -y <package>
claude mcp list
claude mcp remove <name> -s user// .vscode/settings.json
{
"claude.enabled": true,
"claude.autoComplete": true
}| 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 |