{"id":38148319,"url":"https://github.com/netbrain/skeletons","last_synced_at":"2026-01-16T22:58:52.022Z","repository":{"id":323237013,"uuid":"1090188062","full_name":"netbrain/skeletons","owner":"netbrain","description":"Nix flake templates for Claude Code projects with intelligent skills and agent orchestration","archived":false,"fork":false,"pushed_at":"2025-12-04T07:19:27.000Z","size":136,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-07T14:24:44.017Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netbrain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-05T10:36:35.000Z","updated_at":"2025-12-04T07:19:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/netbrain/skeletons","commit_stats":null,"previous_names":["netbrain/skeletons"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/netbrain/skeletons","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbrain%2Fskeletons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbrain%2Fskeletons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbrain%2Fskeletons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbrain%2Fskeletons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netbrain","download_url":"https://codeload.github.com/netbrain/skeletons/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netbrain%2Fskeletons/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28487022,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T22:54:02.790Z","status":"ssl_error","status_checked_at":"2026-01-16T22:50:10.344Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-16T22:58:51.948Z","updated_at":"2026-01-16T22:58:52.011Z","avatar_url":"https://github.com/netbrain.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Code Project Templates\n\nNix flake templates for Claude Code projects with intelligent skills and agent orchestration.\n\n## Quick Start\n\nInitialize a new Claude Code project:\n\n```bash\n# Create and enter new project directory\nmkdir my-project \u0026\u0026 cd my-project\n\n# Initialize from template\nnix flake init -t github:netbrain/skeletons#claude\n\n# Enter development environment\nnix develop\n# or with direnv: direnv allow\n\n# Start Claude Code and initialize your project\n# Just say: \"Let's start a new project\"\n```\n\n## What You Get\n\n### 🚀 project-init skill\nIntelligent project initialization that:\n- Detects empty directories automatically\n- Asks about your tech stack (Go, Node.js, Python, Rust)\n- Creates appropriate project structure\n- Sets up stack-specific skills and agents\n- Configures orchestrator with your preferred personality\n\n### 🛠️ skill-creator skill\nCreate custom Claude Code skills:\n- Scaffolds skill structure with templates\n- Provides best practices and examples\n- Validates skill format\n- Packages for distribution\n\n### 🤖 agent-creator skill\nCreate AI agents with personality:\n- Template library for common patterns\n- Personality options (Friendly, Professional, Analytical)\n- Orchestrator pattern for task delegation\n- Stack-specific recommendations\n\n## Templates\n\n### `claude` (default)\nGeneral-purpose Claude Code project template.\n\n```bash\nnix flake init -t github:netbrain/skeletons#claude\n```\n\nIncludes:\n- Three meta-skills (project-init, skill-creator, agent-creator)\n- Basic flake.nix with common dev tools\n- .gitignore configured for Nix\n- Comprehensive README\n\n## Workflow Example\n\n```bash\n# 1. Initialize project\nmkdir my-api \u0026\u0026 cd my-api\nnix flake init -t github:netbrain/skeletons#claude\n\n# 2. Enter dev environment\nnix develop\n\n# 3. Open Claude Code and initialize\n# Claude detects empty directory and activates project-init\n# You'll be asked:\n#   - Tech stack? (Go, Node.js, Python, Rust)\n#   - Project type? (API, CLI, library, full-stack)\n#   - Agent personality? (Friendly, Professional, Analytical)\n#   - Which agents? (test-runner, linter, security-auditor, etc.)\n\n# 4. Project is now set up with:\n#   - Stack-specific files (go.mod, package.json, etc.)\n#   - Directory structure (src/, tests/, cmd/, etc.)\n#   - Orchestrator agent coordinating work\n#   - Specialist agents for testing, linting, etc.\n#   - Stack-specific TDD skill\n\n# 5. Start coding with your AI team!\n```\n\n## Philosophy\n\nThis template embraces:\n\n**Collaborative Development**: Work with AI agents as a coordinated team, not a single monolithic assistant.\n\n**Orchestration Pattern**: An orchestrator agent gathers context and delegates execution to specialists, following the SessionProcessManager pattern.\n\n**Dynamic Customization**: No rigid templates - everything is built collaboratively based on your needs and preferences.\n\n**Personality-Driven**: Agents communicate like team members with distinct personalities (friendly, professional, analytical).\n\n**Quality First**: Testing, linting, and code review are first-class citizens with dedicated agents.\n\n**Progressive Disclosure**: Skills and agents are created when needed, not all at once.\n\n## Agent Orchestration\n\nEvery project includes an **orchestrator agent** that:\n- Gathers information by reading files and checking status\n- Analyzes what needs to be done\n- Delegates all execution to appropriate specialist agents\n- Never makes changes directly\n- Explains reasoning before delegation\n\nExample orchestrator personalities:\n\n**Professional (Maestro):**\n```\n\"I see you want to add authentication. Let me check the current\nstructure... Based on what I found, I'll have security-auditor\nreview implications first, then code-reviewer can assess the\nimplementation approach.\"\n```\n\n**Friendly (Buddy):**\n```\n\"Hey! Let's add authentication! 🔐 I'll take a look at what we\nhave... Okay, I'm going to ask our security expert to check things\nout first. Sound good?\"\n```\n\n**Analytical (Architect):**\n```\n\"Authentication module request detected. Executing codebase scan...\nSecurity audit required. Delegating to security-auditor agent.\nAwaiting analysis completion.\"\n```\n\n## Stack-Specific Features\n\n### Go Projects\n- `go-tdd` skill for test-driven development\n- `go-test-runner` agent (runs `go test`)\n- `go-linter` agent (golangci-lint)\n- Standard Go project structure (cmd/, pkg/, internal/)\n\n### Node.js/TypeScript\n- `node-tdd` skill with Vitest/Jest\n- `vitest-runner` agent for testing\n- `type-checker` agent (TypeScript)\n- Modern Node.js structure (src/, tests/)\n\n### Python\n- `python-tdd` skill with pytest\n- `pytest-runner` agent\n- `ruff-linter` agent for code quality\n- Python package structure (src/, tests/)\n\n### Rust\n- `rust-tdd` skill with cargo test\n- `cargo-test-runner` agent\n- `clippy-linter` agent\n- Standard Cargo structure\n\n## Creating Custom Skills\n\n```bash\n# Initialize new skill\npython .claude/skills/skill-creator/scripts/init_skill.py my-skill --path .claude/skills\n\n# Edit the generated SKILL.md\nvim .claude/skills/my-skill/SKILL.md\n\n# Validate\npython .claude/skills/skill-creator/scripts/quick_validate.py .claude/skills/my-skill\n\n# Package for distribution\npython .claude/skills/skill-creator/scripts/package_skill.py .claude/skills/my-skill\n```\n\n## Creating Custom Agents\n\nAgents are simple markdown files with YAML frontmatter:\n\n```markdown\n---\nname: my-agent\ndescription: What this agent does and when to use it\nmodel: sonnet\ncolor: blue\ntools: Read, Write, Bash\n---\n\nYou are [agent name], specialized in [domain].\n\n[Define personality, approach, and behavior]\n```\n\nSee `.claude/skills/agent-creator/SKILL.md` for templates and examples.\n\n## Advanced Usage\n\n### Adding More Skills\n```bash\n# Create skill for your domain\npython .claude/skills/skill-creator/scripts/init_skill.py api-design --path .claude/skills\n# Customize for your API patterns\n```\n\n### Creating Agent Teams\n```bash\n# Create specialized agents for your workflow\n# - data-validator (validates data integrity)\n# - api-tester (tests API endpoints)\n# - performance-monitor (watches for regressions)\n```\n\n### Multi-Stack Projects\n```\nmy-monorepo/\n├── backend/ (Go API)\n│   └── .claude/agents/go-*\n├── frontend/ (TypeScript)\n│   └── .claude/agents/ts-*\n└── .claude/\n    ├── skills/ (shared)\n    └── agents/\n        └── orchestrator.md (coordinates both)\n```\n\n## Contributing\n\nContributions welcome! Areas for improvement:\n- Additional language templates\n- More agent templates\n- Enhanced orchestration patterns\n- Documentation improvements\n\n## Resources\n\n- [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code)\n- [Nix Flakes](https://nixos.wiki/wiki/Flakes)\n- [Agent Orchestration Patterns](https://github.com/netbrain/skeletons/blob/main/.claude/skills/agent-creator/SKILL.md)\n\n## License\n\nMIT\n\n---\n\nBuilt with ❤️ using Claude Code and Nix\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetbrain%2Fskeletons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetbrain%2Fskeletons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetbrain%2Fskeletons/lists"}