About app-review
A skill for processing app submissions from GitHub issues, with registration, duplicate, and star validation handled beforehand. It guides categorization, APPS.md updates, and responses or labels for failed checks.
Key features
- 01Parse submission issue fields
- 02Choose an app category
- 03Format APPS.md entries
- 04Handle validation failures
- 05Apply review status labels
Use cases
- 01Process a validated app submission
- 02Add an approved app to APPS.md
- 03Request corrections for incomplete submissions
- 04Mark duplicate or rejected submissions
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ pollinations/ pollinations --skill app-reviewAfter installing, type/app-reviewin Claude Code to confirm it loaded.
Details
From the project READMEApp Review
Process app submissions from GitHub issues. Validation (registration, duplicates, stars) is pre-done by workflow.
Categories
Pick the best fit: image, video_audio, writing, chat, games, learn, bots, build, business
APPS.md Row Format
| EMOJI | Name | Web_URL | Description (~200 chars) | LANG | category | @author | github_id | repo_url | ⭐stars | discord | other | Submitted_Date | Issue_URL | Approved_Date |
- Submitted_Date: Issue creation date (when user submitted)
- Issue_URL: Link to original GitHub issue
- Approved_Date: PR merge date (when app was approved)
If Validation Failed
Comment helpfully based on error:
- Not registered → Ask to register at enter.pollinations.ai
- Duplicate → Explain and close issue
- Add appropriate label (TIER-APP-INCOMPLETE or TIER-APP-REJECTED)
If Validation Passed
# 1. Fetch issue
gh issue view $ISSUE_NUMBER --json body,author,title
# 2. Parse fields: name, url, description, category, repo, discord, language
# 3. Pick creative emoji
# 4. Create/update branch
git fetch origin main
# If existing_pr: checkout and reset
# Else: git checkout -b auto/app-${ISSUE_NUMBER}-slug origin/main
# 5. Add row
export NEW_ROW="| EMOJI | NAME | URL | DESC | LANG | CAT | @AUTHOR | GITHUB_ID | REPO | STARS | DISCORD | | SUBMITTED_DATE | ISSUE_URL | $(date +%Y-%m-%d) |"
node .github/scripts/app-prepend-row.js
node .github/scripts/app-update-greenhouse.js
# 6. Commit and push
git add -A && git commit -m "Add NAME to CATEGORY" && git push origin HEAD --force-with-lease
# 7. Create PR if new
gh pr create --title "Add NAME to CATEGORY" --body "Fixes #$ISSUE_NUMBER"
# 8. Update issue label
gh issue edit $ISSUE_NUMBER --remove-label "TIER-APP" --add-label "TIER-APP-REVIEW"
Labels
| Label | Meaning |
|---|---|
TIER-APP | New submission |
TIER-APP-INCOMPLETE | Waiting for user fix |
TIER-APP-REVIEW | AI reviewed, awaiting maintainer |
TIER-APP-APPROVED | Maintainer approved, PR created |
TIER-APP-REJECTED | Rejected (duplicate, etc.) |
Comments
Markdown supported