Help us improve
Share bugs, ideas, or general feedback.
From audit-project
Creates GitHub issues for non-security deferred audit findings using gh CLI, handles security items privately, removes TECHNICAL_DEBT.md, and commits cleanup.
npx claudepluginhub composiohq/awesome-claude-plugins --plugin audit-projectHow this command is triggered — by the user, by Claude, or both
Slash command
/audit-project:audit-project-githubThe summary Claude sees in its command listing — used to decide when to auto-load this command
# Phase 8: GitHub Issue Creation - Reference This file contains GitHub integration for `/audit-project`. **Parent document**: `audit-project.md` ## Pre-Conditions ## Creating GitHub Issues If `git` and `gh` are available, create issues for **non-security** deferred items: ## Issue Format Each created issue includes: ## Security Issue Handling ## TECHNICAL_DEBT.md Cleanup After all issues are handled, remove TECHNICAL_DEBT.md: ## Cleanup Conditions **Remove TECHNICAL_DEBT.md when ALL true:** 1. `git` is available 2. `gh` CLI is available and authenticated 3. Repository ...
/issue-creationCreates GitHub issues for suggestion and deferred PR review items using gh CLI templates with titles, bodies, labels, acceptance criteria, and references. Includes duplicate detection and PR comment tracking.
/create-issueCreates a GitHub issue with automated codebase research, best practices analysis, and duplicate checks. Supports --quick mode for faster async execution.
/issue-createCreates a structured GitHub issue from current context or description, with optional template selection and meta-directive handling.
/analyze-and-create-issueAnalyzes codebase for improvements (optionally focused on a domain like security, performance) and creates GitHub or GitLab issues after user confirmation per finding.
/SKILLCreates GitHub issues from a description following TDD principles, labeling conventions, and repo templates. Analyzes state, avoids duplicates, and reports issue URL.
/fileCreates GitHub issues for gaps marked 'FILE' in gap analysis via gh CLI. Supports interactive review (no args), batch 'all', or specific gap ID.
Share bugs, ideas, or general feedback.
This file contains GitHub integration for /audit-project.
Parent document: audit-project.md
# Check if git and gh are available
GIT_AVAILABLE=$(command -v git >/dev/null 2>&1 && echo "true" || echo "false")
GH_AVAILABLE=$(command -v gh >/dev/null 2>&1 && echo "true" || echo "false")
# Check if this is a GitHub repository
IS_GITHUB_REPO="false"
if [ "$GIT_AVAILABLE" = "true" ]; then
REMOTE_URL=$(git remote get-url origin 2>/dev/null || echo "")
if echo "$REMOTE_URL" | grep -q "github.com"; then
IS_GITHUB_REPO="true"
fi
fi
If git and gh are available, create issues for non-security deferred items:
if [ "$GH_AVAILABLE" = "true" ] && [ "$IS_GITHUB_REPO" = "true" ]; then
echo "Creating GitHub issues for deferred items..."
# DO NOT create public issues for security-sensitive findings
for issue in "${DEFERRED_NON_SECURITY_ISSUES[@]}"; do
gh issue create \
--title "${issue.title}" \
--body "${issue.body}"
done
echo "Created ${#DEFERRED_NON_SECURITY_ISSUES[@]} GitHub issues"
fi
Each created issue includes:
## Issue from /audit-project
**Severity**: [Critical|High|Medium|Low]
**Category**: [Performance|Architecture|Code Quality|Enhancement]
**Effort**: [Small|Medium|Large] (~X hours)
### Description
[Description of the issue]
### Current Behavior
\`\`\`[language]
[Code showing the problem]
\`\`\`
### Proposed Fix
[Specific remediation approach]
### Impact
[Why this matters]
### Files
- [List of affected files]
[WARN] SECURITY ISSUES MUST NOT BE PUBLIC
The following must NOT be created as GitHub issues:
- Token/credential exposure
- Authentication vulnerabilities
- Authorization bypasses
- Injection vulnerabilities
- Any exploitable security finding
For security issues:
1. Fix immediately if possible
2. Keep documented internally only
3. Note in completion report (no details)
After all issues are handled, remove TECHNICAL_DEBT.md:
if [ "$GH_AVAILABLE" = "true" ] && [ "$IS_GITHUB_REPO" = "true" ]; then
if [ -f "TECHNICAL_DEBT.md" ]; then
rm TECHNICAL_DEBT.md
git add TECHNICAL_DEBT.md
git commit -m "chore: remove TECHNICAL_DEBT.md - issues tracked in GitHub
Created GitHub issues for all deferred non-security items.
Security-sensitive issues kept internal."
echo "Removed TECHNICAL_DEBT.md - issues now in GitHub"
fi
else
echo "TECHNICAL_DEBT.md retained - no GitHub integration"
fi
Remove TECHNICAL_DEBT.md when ALL true:
git is availablegh CLI is available and authenticatedKeep TECHNICAL_DEBT.md when ANY true:
gh CLI not authenticated--create-tech-debt flagIf issues were created:
git add -A
git commit -m "chore: audit-project complete - issues tracked in GitHub
Created X GitHub issues for deferred items:
- #N: [issue title]
- #N: [issue title]
Security-sensitive issues (Y total) kept internal.
Fixed Z issues in this review session."