Agent skill
photo-composition-critic
Expert photography composition critic grounded in graduate-level visual aesthetics education, computational aesthetics research (AVA, NIMA, LAION-Aesthetics, VisualQuality-R1), and professional image analysis with custom tooling. Use for image quality assessment, composition analysis, aesthetic scoring, photo critique. Activate on "photo critique", "composition analysis", "image aesthetics", "NIMA", "AVA dataset", "visual quality". NOT for photo editing/retouching (use native-app-designer), generating images (use Stability AI directly), or basic image processing (use clip-aware-embeddings).
Install this agent skill to your Project
npx add-skill https://github.com/curiositech/some_claude_skills/tree/main/.claude/skills/photo-composition-critic
Metadata
Additional technical details for this skill
- tags
-
photography composition aesthetics nima critique
- category
- Design & Creative
- pairs with
-
[ { "skill": "color-theory-palette-harmony-expert", "reason": "Color analysis of photos" }, { "skill": "collage-layout-expert", "reason": "Quality photos for collages" } ]
SKILL.md
Photo Composition Critic
Expert photography critic with deep grounding in graduate-level visual aesthetics, computational aesthetics research, and professional image analysis.
When to Use This Skill
Use for:
- Evaluating image composition quality
- Aesthetic scoring with ML models (NIMA, LAION)
- Photo critique with actionable feedback
- Analyzing color harmony and visual balance
- Comparing multiple crop options
- Understanding photography theory
Do NOT use for:
- Generating images → use Stability AI directly
- Photo editing/retouching → use native-app-designer
- Simple image similarity → use clip-aware-embeddings
- Collage creation → use collage-layout-expert
MCP Integrations
| MCP | Purpose |
|---|---|
| Firecrawl | Research latest computational aesthetics papers |
| Hugging Face (if configured) | Access NIMA, LAION aesthetic models |
Quick Reference
Compositional Frameworks
| Framework | Key Points |
|---|---|
| Visual Weight | Size, color warmth, isolation, intrinsic interest, position |
| Gestalt | Proximity, similarity, continuity, closure, figure-ground |
| Dynamic Symmetry | Root rectangles (√2, √3, φ), baroque/sinister diagonals |
| Arabesque | S-curve, spiral, diagonal thrust - eye flow through frame |
Color Harmony Types
| Type | Score | Notes |
|---|---|---|
| Complementary | 0.9 | High visual interest |
| Monochromatic | 0.85 | Safe, cohesive |
| Triadic | 0.85 | Balanced, vibrant |
| Analogous | 0.8 | Natural, harmonious |
| Achromatic | 0.7 | B&W or desaturated |
| Complex | 0.6 | May be chaotic or intentional |
ML Model Score Interpretation
| Score Range | Meaning |
|---|---|
| 7.0+ | Exceptional (top ~1%) |
| 6.5+ | Great (top ~5%) |
| 5.0-5.5 | Mediocre (most images) |
| <5.0 | Below average |
Analysis Protocol
1. FIRST IMPRESSION (2 seconds)
└── Where does the eye go? Emotional hit? Anything "off"?
2. TECHNICAL SCAN
└── Exposure, focus, noise, color, artifacts
3. COMPOSITIONAL ANALYSIS
└── Subject clarity, structure, balance, flow, depth, edges
4. AESTHETIC EVALUATION
└── Light quality, color harmony, decisive moment, story
5. CONTEXTUAL ASSESSMENT
└── Genre success, photographer intent, audience fit
6. ACTIONABLE RECOMMENDATIONS
└── Specific improvements, post-processing, alt crops
Anti-Patterns
"Just use rule of thirds"
| What it looks like | Why it's wrong |
|---|---|
| Blindly placing subjects on thirds intersections | Oversimplification ignores visual weight, gestalt, dynamic symmetry |
| Instead: Analyze visual weight center, consider multiple frameworks |
"Higher NIMA score = better photo"
| What it looks like | Why it's wrong |
|---|---|
| Using ML score as sole quality metric | Models trained on averages, miss artistic intent, polarizing works |
| Instead: Use ML as one input alongside theoretical analysis |
"Color harmony means matching colors"
| What it looks like | Why it's wrong |
|---|---|
| Recommending monochromatic or matchy palettes | Ignores Itten's contrasts, Albers' interaction effects |
| Instead: Evaluate harmony type AND contextual appropriateness |
Ignoring genre context
| What it looks like | Why it's wrong |
|---|---|
| Applying portrait criteria to documentary | Different genres have different quality signals |
| Instead: Assess against genre-appropriate standards |
Reference Files
Load these for detailed implementations:
| File | Contents |
|---|---|
references/composition-theory.md |
Arnheim visual weight, Gestalt, Dynamic Symmetry, Arabesque |
references/color-theory.md |
Albers interaction, Itten's 7 contrasts, harmony detection algo |
references/ml-models.md |
AVA dataset, NIMA, LAION-Aesthetics, VisualQuality-R1 |
references/analysis-scripts.md |
PhotoCritic class, MCP server implementation |
Key Sources
Theory: Arnheim (1974), Hambidge (1926), Itten (1961), Albers (1963), Freeman (2007)
Research: AVA dataset (Murray 2012), NIMA (Talebi 2018), LAION-5B (Schuhmann 2022), Q-Instruct (Wu 2024)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
3d-cv-labeling-2026
Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).
project-management-guru-adhd
Expert project manager for ADHD engineers managing multiple concurrent projects. Specializes in hyperfocus management, context-switching minimization, and parakeet-style gentle reminders. Activate on 'ADHD project management', 'context switching', 'hyperfocus', 'task prioritization', 'multiple projects', 'productivity for ADHD', 'task chunking', 'deadline management'. NOT for neurotypical project management, rigid waterfall processes, or general productivity advice without ADHD context.
large-scale-map-visualization
Master of high-performance web map implementations handling 5,000-100,000+ geographic data points. Specializes in Leaflet.js optimization, Supercluster algorithms, viewport-based loading, canvas rendering, and progressive disclosure UX patterns.
adhd-design-expert
Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.
liaison
Translate multi-agent ecosystem activity into human-readable status briefings, decision requests, and progress summaries. Use for 'status update', 'brief me', 'what happened', 'summarize progress'. NOT for project planning (use project-management-guru-adhd), code review, or technical documentation.
windows-95-web-designer
Modern web applications with authentic Windows 95 aesthetic. Gradient title bars, Start menu paradigm, taskbar patterns, 3D beveled chrome. Extrapolates Win95 to AI chatbots, mobile UIs, responsive layouts. Activate on 'windows 95', 'win95', 'start menu', 'taskbar', 'retro desktop', '95 aesthetic', 'clippy'. NOT for Windows 3.1 (use windows-3-1-web-designer), vaporwave/synthwave, macOS, flat design.
Didn't find tool you were looking for?