# App Review

> App Review is an Agent Skill for testing & quality published in the pollinations/pollinations repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Review and process app submissions for the Pollinations showcase. Parse issues, validate submissions, create PRs, handle user corrections.

- Skill name: `app-review`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/pollinations/pollinations/blob/HEAD/.claude/skills/app-review/SKILL.md
- Repository: pollinations/pollinations (4,834 GitHub stars when collected)

## SKILL.md

# App 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

```bash
# 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.) |

---

Source: https://www.openparable.com/skill/testing-quality/app-review (OpenParable). Cite the canonical URL above.
