{"id":28532482,"url":"https://github.com/y-a-v-a/claude-code-custom-commands","last_synced_at":"2025-07-12T08:09:33.652Z","repository":{"id":295438889,"uuid":"990118468","full_name":"y-a-v-a/claude-code-custom-commands","owner":"y-a-v-a","description":"Custom commands for Claude Code","archived":false,"fork":false,"pushed_at":"2025-07-05T22:39:45.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-05T23:28:32.583Z","etag":null,"topics":["aicodeassistant","claude-ai","claude-code"],"latest_commit_sha":null,"homepage":"","language":null,"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/y-a-v-a.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}},"created_at":"2025-05-25T14:42:11.000Z","updated_at":"2025-07-05T22:39:48.000Z","dependencies_parsed_at":"2025-05-25T15:43:57.260Z","dependency_job_id":"d56cee0d-8a45-494d-b515-d89639b6bd69","html_url":"https://github.com/y-a-v-a/claude-code-custom-commands","commit_stats":null,"previous_names":["y-a-v-a/claude-cude-custom-commands","y-a-v-a/claude-code-custom-commands"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/y-a-v-a/claude-code-custom-commands","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y-a-v-a%2Fclaude-code-custom-commands","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y-a-v-a%2Fclaude-code-custom-commands/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y-a-v-a%2Fclaude-code-custom-commands/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y-a-v-a%2Fclaude-code-custom-commands/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/y-a-v-a","download_url":"https://codeload.github.com/y-a-v-a/claude-code-custom-commands/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/y-a-v-a%2Fclaude-code-custom-commands/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264958623,"owners_count":23689035,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["aicodeassistant","claude-ai","claude-code"],"created_at":"2025-06-09T15:38:24.835Z","updated_at":"2025-07-12T08:09:33.633Z","avatar_url":"https://github.com/y-a-v-a.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Code Custom Commands\n\nThis repository contains custom commands for Claude Code that extend its functionality with project-specific automation tools.\n\n**Current Version:** 1.1.0\n\n## Commands\n\n### Version Command\n\nA semantic version management command that handles versioning for projects using a VERSION file and Git tags.\n\n#### Usage\n\n```bash\n\u003e /project:y-version \u003csubcommand\u003e\n```\n\n#### Subcommands\n\n- **`current`** - Display current version without making changes\n- **`patch`** - Increment patch version (e.g., 1.2.3 → 1.2.4)\n- **`minor`** - Increment minor version and reset patch (e.g., 1.2.3 → 1.3.0)\n- **`major`** - Increment major version and reset minor/patch (e.g., 1.2.3 → 2.0.0)\n- **`set X.Y.Z`** - Set specific version (e.g., `set 2.1.0`)\n\n#### Features\n\n- **Automatic VERSION file creation**: Creates VERSION file with \"0.0.1\" if it doesn't exist\n- **Semantic version validation**: Validates proper semver format (MAJOR.MINOR.PATCH)\n- **Git integration**: Creates git tags with format \"v{version}\" and commits with descriptive messages\n- **Multi-format support**: Updates version in package.json, Cargo.toml, and pyproject.toml if present\n- **Dry-run mode**: Use `--dry-run` flag to preview changes without applying them\n- **Pre-release support**: Handles versions like \"1.0.0-alpha.1\", \"2.0.0-beta.2\"\n- **Build metadata**: Supports build metadata like \"1.0.0+build.123\"\n\n#### Safety Features\n\n- **Clean working directory check**: Verifies git working directory is clean before making changes\n- **Branch validation**: Optional check for main/master branch\n- **Error handling**: Gracefully handles invalid versions, git issues, and network problems\n- **Remote sync**: Automatically pushes tags to origin\n\n#### Examples\n\n```bash\n# In Claude Code\n\n# Show current version\n\u003e /project:y-version current\n\n# Increment patch version\n\u003e /project:y-version patch\n\n# Increment minor version\n\u003e /project:y-version minor\n\n# Increment major version\n\u003e /project:y-version major\n\n# Set specific version\n\u003e /project:y-version set 2.1.0\n\n# Preview changes without applying\n\u003e /project:y-version patch --dry-run\n```\n\n#### Output Examples\n\n**Dry-run mode:**\n```\n[DRY RUN] Would update version: 1.2.3 → 1.2.4\n[DRY RUN] Would update VERSION file\n[DRY RUN] Would update package.json\n[DRY RUN] Would create git tag: v1.2.4\n[DRY RUN] Would commit with message: \"Release version 1.2.4\"\n[DRY RUN] Would push tag to origin\n\nNo changes made. Use without --dry-run to apply changes.\n```\n\n**Successful execution:**\n```\n✅ Updated version: 1.2.3 → 1.2.4\n✅ Updated VERSION file\n✅ Updated package.json\n✅ Created git tag: v1.2.4\n✅ Committed: \"Release version 1.2.4\"\n✅ Pushed tag to origin\n```\n\n### Update README Command\n\nA command that automatically updates the README.md file based on recent repository changes and project structure.\n\n#### Usage\n\n```bash\n\u003e /project:y-update-readme [custom instructions]\n```\n\n#### Features\n\n- **Intelligent analysis**: Analyzes recent git commits, file structure, and existing documentation\n- **Content preservation**: Maintains manually written content while updating generated sections\n- **Custom instructions**: Accepts additional requirements via arguments\n- **Version awareness**: Includes current version from VERSION file\n- **Technology detection**: Automatically detects and documents tech stack\n- **Link validation**: Ensures internal links work and external links are valid\n\n#### Examples\n\n```bash\n# Basic README update\n\u003e /project:y-update-readme\n\n# Update with custom instructions\n\u003e /project:y-update-readme update copyright information\n\u003e /project:y-update-readme add API documentation section\n\u003e /project:y-update-readme include deployment instructions\n```\n\n#### What Gets Updated\n\n- Project description and current version\n- Installation and usage instructions\n- API documentation from code analysis\n- Dependencies and requirements\n- Contributing guidelines and license information\n- Technology stack documentation\n\n## Installation\n\n1. Clone this repository to your Claude Code commands directory\n2. Commands will be available as:\n   - `/project:y-version` - Semantic version management\n   - `/project:y-update-readme` - README.md updates\n\n## Requirements\n\n- Git repository with clean working directory\n- Appropriate permissions for creating tags and pushing to origin\n- Network connectivity for pushing tags to remote repository\n\n## Error Handling\n\nThe commands include robust error handling for common scenarios:\n- Invalid semantic version formats\n- Dirty git working directory\n- Network issues when pushing\n- Missing git repository\n- Permission issues\n- File system errors\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fy-a-v-a%2Fclaude-code-custom-commands","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fy-a-v-a%2Fclaude-code-custom-commands","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fy-a-v-a%2Fclaude-code-custom-commands/lists"}