{
  "markdown": "# Claude AI Skill Generator\n\nA comprehensive template repository system for bootstrapping AI-assisted development projects with Claude Code integration. This repository provides production-ready templates, domain-specific skills, and automated setup scripts to quickly initialize new projects optimized for AI-assisted development.\n\n## 🚀 Quick Start\n\n```bash\n# Clone this repository\ngit clone https://github.com/martinholovsky/claude-skills-generator.git\ncd claude-skills-generator\n\n# Run the setup script (interactive mode)\n./setup-repo-multitype.sh /path/to/your/new-project\n\n# Or use the original script\n./init-new-repo.sh /path/to/your/new-project\n```\n\nThe script will guide you through:\n- Project type selection (Web, Backend, Full-Stack, Desktop, CLI, Library)\n- Language selection (TypeScript, Python, Rust, etc.)\n- Feature selection and skill copying\n- Template file generation with your project details\n- Git repository initialization\n\n## 📋 What's Included\n\n### 1. **Interactive Setup Scripts**\n\n- **`setup-repo-multitype.sh`** - Enhanced setup with multi-type support\n- **`init-new-repo.sh`** - Original comprehensive setup script\n\nBoth scripts provide:\n- Interactive project configuration\n- Automatic skill selection based on project type\n- Template variable substitution\n- Git repository initialization\n- Claude Code configuration\n\n### 2. **Production-Ready Templates**\n\nAll template files use placeholders (e.g., `{{PROJECT_NAME}}`) that get replaced during setup:\n\n- **`CLAUDE.md`** - Claude Code project instructions (auto-read by Claude)\n- **`README.md`** - Project documentation template\n- **`CONTRIBUTING.md`** - Contribution guidelines with AI-assisted workflows\n- **`SECURITY.md`** - Security policy with AI-specific considerations\n- **`CODE_OF_CONDUCT.md`** - Community code of conduct\n- **`.gitignore`** - Comprehensive ignore patterns\n- **`.env.example`** - Environment variable template\n\n### 3. **Claude Code Integration**\n\nThe `.claude/` directory contains:\n\n**Configuration:**\n- `settings.json` - Hooks configuration (pre/post tool use, formatting)\n\n**Slash Commands** (user-invoked):\n- `/implement-feature` - Feature implementation workflow\n- `/run-tests` - Automated test execution\n- `/review-code` - Code review checklist\n\n### 4. **GitHub Templates**\n\nThe `.github/` directory includes:\n\n- **`workflows/ci.yml`** - CI/CD pipeline (lint, test, build, security audit)\n- **`PULL_REQUEST_TEMPLATE.md`** - PR template with AI disclosure section\n- **Issue Templates:**\n  - `bug_report.md`\n  - `feature_request.md`\n\n### 5. **Domain-Specific Skills (67+ Skills)**\n\nSpecialized knowledge modules for specific technologies. See [SKILLS_REFERENCE.md](./SKILLS_REFERENCE.md) for the complete catalog.\n\n**Categories:**\n- **Frontend/UI** (11): Vue, Nuxt, Pinia, Tailwind, GSAP, Three.js, WebGL, Design Systems, UI/UX\n- **Backend/API** (15): FastAPI, GraphQL, REST, WebSocket, JSON-RPC, async, Celery, RabbitMQ, MCP\n- **Languages** (4): TypeScript, JavaScript, Python, Rust\n- **Databases** (5): SQLite, SQLCipher, SurrealDB, Graph Databases, Database Design\n- **Security** (6): AppSec, Security Auditing, Encryption, OS Keychain, Sandboxing, DevSecOps\n- **DevOps** (8): CI/CD, ArgoCD, Cilium, Harbor, Talos OS, Kanidm, Cloud APIs, Cross-Platform Builds\n- **Desktop** (3): Tauri, Browser Automation, Auto-Update Systems\n- **Platform-Specific** (7): macOS, Windows, Linux accessibility and automation\n- **AI/ML** (4): LLM Integration, Model Quantization, Prompt Engineering, Speech/Wake-Word\n- **Multimedia** (2): Web Audio API, Text-to-Speech/Speech-to-Text\n- **Accessibility** (2): WCAG, platform-specific accessibility\n\nEach skill includes:\n- Core principles and best practices\n- Security considerations and CVE tracking\n- Code patterns and examples\n- Risk level classification (HIGH/MEDIUM/LOW)\n- Extended references for advanced patterns\n\n## 🎯 Key Features\n\n### Security-First Development\n- OWASP Top 10 awareness built into all templates\n- CVE tracking in skill files\n- Credential management via OS keychain\n- Input validation emphasis\n- Security audit workflows\n\n### AI-Assisted Development Guidelines\n- TDD-first principles\n- Skill loading protocols\n- Security review requirements\n- AI code verification procedures\n- Conventional commit format enforcement\n\n### Template Variable System\nAll templates use placeholders that get replaced during setup:\n- `{{PROJECT_NAME}}` - Your project name\n- `{{PROJECT_DESCRIPTION}}` - Project description\n- `{{ARCHITECTURE_DESCRIPTION}}` - Architecture overview\n- `{{TEST_COMMAND}}` - Test command\n- `{{BUILD_COMMAND}}` - Build command\n- `{{DEV_COMMAND}}` - Development command\n- And many more...\n\n## 📖 Documentation\n\n- **[USAGE.md](./USAGE.md)** - Detailed usage guide with examples\n- **[SKILLS_REFERENCE.md](./SKILLS_REFERENCE.md)** - Complete skills catalog\n- **[CLAUDE_CODE_ARCHITECTURE.md](./CLAUDE_CODE_ARCHITECTURE.md)** - Claude Code integration architecture (template)\n- **[CONTRIBUTING.md](./CONTRIBUTING.md)** - Contribution guidelines (template)\n\n## 🛠️ Supported Project Types\n\n### 1. Web Application\n- Frontend SPAs (React, Vue, Svelte)\n- SSR frameworks (Next.js, Nuxt)\n- Relevant skills: vue-nuxt, tailwindcss, pinia, ui-ux-design\n\n### 2. Backend/API\n- REST APIs (FastAPI, Express, NestJS)\n- GraphQL APIs\n- WebSocket servers\n- Relevant skills: fastapi, rest-api-design, graphql, websocket\n\n### 3. Full-Stack\n- Monorepo setups\n- Combined frontend + backend\n- Relevant skills: Combination of web + backend skills\n\n### 4. Desktop Application\n- Cross-platform apps (Tauri, Electron)\n- Native integrations\n- Relevant skills: tauri, browser-automation, auto-update-systems\n\n### 5. CLI Tool\n- Command-line applications\n- Terminal utilities\n- Relevant skills: python, rust, typescript\n\n### 6. Library/Package\n- Reusable libraries\n- npm/PyPI/crates.io packages\n- Relevant skills: Language-specific skills\n\n## 🔧 How It Works\n\n### 1. Setup Process\n\n```bash\n./setup-repo-multitype.sh my-new-project\n```\n\nThe script will:\n1. **Prompt for project details:**\n   - Project name and description\n   - Project type(s) (multi-select supported)\n   - Programming language(s)\n   - Features and frameworks\n\n2. **Copy relevant skills:**\n   - Automatically selects skills based on your choices\n   - Copies selected skills to your project's `skills/` directory\n\n3. **Generate configuration files:**\n   - Replaces template variables with your values\n   - Creates `.claude/` configuration\n   - Sets up `.github/` workflows\n\n4. **Initialize Git repository:**\n   - Creates initial commit\n   - Sets up branch structure (optional)\n\n### 2. Template Variable Replacement\n\nDuring setup, all template files are processed:\n\n**Before:**\n```markdown\n# {{PROJECT_NAME}}\n\n{{PROJECT_DESCRIPTION}}\n```\n\n**After:**\n```markdown\n# My Awesome Project\n\nA full-stack application for managing tasks with AI assistance.\n```\n\n### 3. Skill Loading\n\nSkills are loaded based on your project configuration:\n\n- **Automatic:** Selected during setup based on project type\n- **Manual:** Copy additional skills from the `skills/` directory\n- **Claude Code:** Reference skills in your `CLAUDE.md` or slash commands\n\n## 🎓 Usage Examples\n\n### Example 1: Full-Stack Web Application\n\n```bash\n./setup-repo-multitype.sh ~/projects/task-manager\n\n# Interactive prompts:\n# - Project name: task-manager\n# - Type: 3 (Full-Stack)\n# - Language: 1 (TypeScript)\n# - Framework: Nuxt 3 + FastAPI\n# - Features: Database (SQLite), Authentication, API\n```\n\n**Result:**\n- Vue/Nuxt frontend skills\n- FastAPI backend skills\n- Database design and SQLite skills\n- TypeScript configuration\n- Full CI/CD pipeline\n- Claude Code integration\n\n### Example 2: Desktop Application\n\n```bash\n./setup-repo-multitype.sh ~/projects/my-desktop-app\n\n# Interactive prompts:\n# - Project name: my-desktop-app\n# - Type: 4 (Desktop)\n# - Framework: Tauri\n# - Features: Auto-updates, System integration\n```\n\n**Result:**\n- Tauri skill with security patterns\n- Auto-update systems skill\n- Platform-specific skills (macOS, Windows, Linux)\n- Rust + TypeScript configuration\n- Cross-platform build workflows\n\n### Example 3: Python CLI Tool\n\n```bash\n./setup-repo-multitype.sh ~/projects/cli-tool\n\n# Interactive prompts:\n# - Project name: cli-tool\n# - Type: 5 (CLI)\n# - Language: 3 (Python only)\n# - Features: Configuration, Logging\n```\n\n**Result:**\n- Python skill with best practices\n- CLI patterns and examples\n- Testing configuration (pytest)\n- PyPI packaging setup\n\n## 🤖 Claude Code Integration\n\nAfter project creation, Claude Code automatically:\n\n1. **Reads `CLAUDE.md`** at session start\n2. **Applies project-specific rules** and guidelines\n3. **Uses skills** when invoked via commands or instructions\n4. **Enforces security** and code quality standards\n5. **Runs hooks** for formatting and validation\n\n### Working with Claude Code\n\n```bash\n# In your new project\ncd my-new-project\n\n# Claude Code automatically reads CLAUDE.md\n# Use slash commands:\n/implement-feature     # Load feature implementation workflow\n/run-tests            # Run all tests automatically\n/review-code          # Run code review checklist\n\n# Skills are referenced in CLAUDE.md and loaded as needed\n```\n\n## 📦 Project Structure After Setup\n\n```\nmy-new-project/\n├── CLAUDE.md                          # Claude's project instructions\n├── README.md                          # Your project documentation\n├── CONTRIBUTING.md                    # Contribution guidelines\n├── SECURITY.md                        # Security policy\n├── CODE_OF_CONDUCT.md                 # Code of conduct\n│\n├── .claude/\n│   ├── settings.json                  # Claude Code configuration\n│   └── commands/                      # Slash commands\n│       ├── implement-feature.md\n│       ├── run-tests.md\n│       └── review-code.md\n│\n├── .github/\n│   ├── workflows/\n│   │   └── ci.yml                     # CI/CD pipeline\n│   ├── PULL_REQUEST_TEMPLATE.md\n│   └── ISSUE_TEMPLATE/\n│       ├── bug_report.md\n│       └── feature_request.md\n│\n├── skills/                            # Relevant domain skills\n│   ├── typescript/\n│   ├── fastapi/\n│   ├── database-design/\n│   └── ...\n│\n├── src/                               # Your source code\n└── tests/                             # Your tests\n```\n\n## 🔒 Security Considerations\n\n### Built-in Security Features\n\n- **OWASP Top 10** awareness in all templates\n- **CVE tracking** in security-sensitive skills\n- **Credential management** via OS keychain (never plaintext)\n- **Input validation** emphasis throughout\n- **Security audit** workflow in CI/CD\n- **Sandboxing** guidelines for file operations\n- **Security policy** template for responsible disclosure\n\n### Security Skills\n\nThe repository includes specialized security skills:\n- **appsec-expert** - Application security patterns\n- **security-auditing** - Security review checklists\n- **encryption** - Cryptography best practices\n- **os-keychain** - Secure credential storage\n- **sandboxing** - File system isolation\n- **devsecops-expert** - Security automation\n\n## 🤝 Contributing\n\nThis is a template repository designed to bootstrap new projects. Contributions are welcome!\n\n### How to Contribute\n\n1. **Add new skills:**\n   - Create skill directory: `skills/your-skill/`\n   - Add `SKILL.md` with patterns and security considerations\n   - Include risk level classification\n   - Add references if needed\n\n2. **Improve templates:**\n   - Enhance existing template files\n   - Add new template variables\n   - Improve Claude Code integration\n\n3. **Enhance setup scripts:**\n   - Add new project types\n   - Improve interactive prompts\n   - Add validation and error handling\n\n4. **Update documentation:**\n   - Improve usage examples\n   - Add troubleshooting guides\n   - Document new features\n\n### Contribution Guidelines\n\n- Follow security-first principles\n- Include examples and documentation\n- Test setup scripts thoroughly\n- Maintain template variable consistency\n- Follow conventional commit format\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built for use with [Claude Code](https://claude.ai/code) by Anthropic\n- Inspired by best practices from the open-source community\n- Security patterns from OWASP and CVE databases\n- Framework-specific patterns from official documentation\n\n## 📞 Support\n\n- **Documentation:** See [USAGE.md](./USAGE.md) for detailed usage instructions\n- **Skills Reference:** See [SKILLS_REFERENCE.md](./SKILLS_REFERENCE.md) for all available skills\n- **Issues:** Report issues via GitHub Issues\n- **Questions:** Open a discussion in GitHub Discussions\n\n---\n\n**Built with ❤️ for AI-assisted development**\n",
  "bytes": 12624,
  "sha": "89e94fae2142632a93e3ff19f37bcbf0a9c3d6450a2dddd020b9cb47e007b570",
  "repo_slug": "martinholovsky/claude-skills-generator",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_martinholovsky_claude_skills_generator_s_f9b8deb4/readme"
}