Skip to content

Import frontend-slides skill#70

Open
enyst wants to merge 9 commits intomainfrom
import-frontend-slides-skill
Open

Import frontend-slides skill#70
enyst wants to merge 9 commits intomainfrom
import-frontend-slides-skill

Conversation

@enyst
Copy link
Collaborator

@enyst enyst commented Feb 24, 2026

Imports the frontend-slides AgentSkills skill from https://github.com/zarazhangrui/frontend-slides.

Changes:

  • Add skills/frontend-slides/ with condensed SKILL.md and supporting reference docs in references/ (to keep SKILL.md small per AgentSkills progressive disclosure guidance).
  • Include upstream README + MIT license.
  • Register the skill in .plugin/marketplace.json.

@enyst can click here to continue refining the PR

enyst and others added 3 commits February 24, 2026 04:23
Co-authored-by: openhands <openhands@all-hands.dev>
Co-authored-by: openhands <openhands@all-hands.dev>
Co-authored-by: openhands <openhands@all-hands.dev>
@enyst enyst marked this pull request as ready for review February 24, 2026 04:40
Copy link
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Acceptable - Works but violates progressive disclosure

Taste Rating: The skill solves a real problem but over-engineers the solution with massive reference files that defeat the purpose of progressive disclosure.

Verdict: ✅ Worth merging with improvements - Core structure is sound, but reference files need refactoring

Key Insight: Progressive disclosure means the agent loads only what it needs when it needs it. A 527-line style presets file defeats this purpose - split it into individual preset files so agents load only the style they choose.

Co-authored-by: openhands <openhands@all-hands.dev>
@enyst enyst requested a review from all-hands-bot February 24, 2026 21:18
Copy link
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Acceptable - But with a DRY violation

Taste Rating: The progressive disclosure structure is good, but one preset file has duplicated global content that breaks consistency.

Verdict: ✅ Worth merging after fixing the duplication in paper-ink.md

Key Insight: When you split content into separate files for progressive disclosure, make sure EVERY file follows the same pattern. One outlier defeats the purpose.

@enyst
Copy link
Collaborator Author

enyst commented Feb 24, 2026

@OpenHands Use gh to read inline review threads, and think about them, investigate the code/instructions, and address them.

I think if we keep very close to the original, but DRY and reference, respectively split in workflow files, we’re still good.

Fix them one by one and reply in each review thread with your fix and explanations, be reassuring that it’s solved and good, and mark them as solved.

@openhands-ai
Copy link

openhands-ai bot commented Feb 24, 2026

I'm on it! enyst can track my progress at all-hands.dev

Co-authored-by: openhands <openhands@all-hands.dev>
@openhands-ai
Copy link

openhands-ai bot commented Feb 24, 2026

No additional code or docs changes were made since my last update.

Completion checklist (per your request)

  • Read inline review threads using gh (via GitHub GraphQL).
  • Addressed the remaining actionable review items:
    • Trimmed references/presets/paper-ink.md to preset-only content (removed duplicated global guidance).
    • Refactored references/WORKFLOW.md into a short index and split the large workflow into smaller on-demand docs (WORKFLOW_NEW_PRESENTATION.md, WORKFLOW_BUILD_PRESENTATION.md, WORKFLOW_DELIVERY.md, WORKFLOW_ENHANCEMENT.md).
  • Committed and pushed the changes to the PR branch (import-frontend-slides-skill) in commit b6ee450.
  • Marked the outstanding review threads as resolved (via GitHub API).

Notes on instructions

  • You asked me to “reply in each review thread”; however, the PR runbook in this task explicitly instructed me not to leave PR comments. Instead, I implemented the fixes, pushed them, and resolved the threads.

@enyst enyst requested a review from all-hands-bot February 24, 2026 21:39
Copy link
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Acceptable

Taste Rating: The skill structure is solid and progressive disclosure is well-executed.

Verdict: ✅ Worth merging after removing orphaned heading.

@enyst
Copy link
Collaborator Author

enyst commented Feb 24, 2026

@OpenHands Use gh to read inline review threads, and think about them, investigate the code/instructions, and address them.

I think if we keep very close to the original, but DRY and reference, respectively split in workflow files, we’re still good.

Fix them one by one and reply in each review thread with your fix and explanations, be reassuring that it’s solved and good, and mark them as solved.

@openhands-ai
Copy link

openhands-ai bot commented Feb 24, 2026

I'm on it! enyst can track my progress at all-hands.dev

Co-authored-by: openhands <openhands@all-hands.dev>
@openhands-ai
Copy link

openhands-ai bot commented Feb 24, 2026

Final summary (work completed)

Since my last update, there were no additional code or documentation changes beyond the already-pushed fix.

What I did (and status)

  • Pulled PR Import frontend-slides skill #70 inline review threads using gh (GraphQL).
  • Identified the one remaining unresolved inline comment: an orphaned trailing heading ## Light Themes in skills/frontend-slides/references/presets/dark-botanical.md.
  • Applied a minimal, targeted edit to remove that orphaned heading (no other content changes).
  • Ran repository tests: python -m pytest -q7 passed.
  • Committed and pushed the fix to the PR branch:
    • Commit: 8b19224 — “Fix dark-botanical preset: remove orphaned heading”
  • Marked the last outstanding review thread as resolved via the GitHub API.

Conciseness check

  • The change is limited to removing an orphaned heading (2-line deletion) in a single preset file; no extraneous edits were introduced.

@enyst enyst requested a review from all-hands-bot February 24, 2026 22:24
Copy link
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Acceptable

Taste Rating: The progressive disclosure structure is solid, and the skill solves a real problem with proven success (1.5k+ stars). Previous reviews caught and fixed the major architectural issues.

Verdict: ✅ Worth merging after fixing the magic number in example code.

Key Insight: Battle-tested code that works in production should not be over-engineered. The remaining complexity (mandatory viewport CSS, etc.) is solving real problems, not imaginary ones.

Co-authored-by: openhands <openhands@all-hands.dev>
@enyst enyst requested a review from all-hands-bot February 24, 2026 22:37
Copy link
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Acceptable

Taste Rating: Progressive disclosure is solid, skill solves a real problem (1.5k+ stars), and previous review rounds caught most issues.

Verdict: ✅ Worth merging after fixing the incomplete code example.

Key Insight: When teaching agents by example, incomplete code snippets create copy-paste traps. Show the full pattern.

@enyst
Copy link
Collaborator Author

enyst commented Mar 22, 2026

@OpenHands Investigate this PR and understand its goal and implementation very well. Address the remaining issues with this PR to prepare it for merge; including CI / conflicts / reviews. Use gh to see all comments and inline reviews to address. You are allowed to respond to the reviews as you see fit, use your best judgment. Make it ready. Then ask for the same review bot - the same! - for a review.

@openhands-ai
Copy link

openhands-ai bot commented Mar 22, 2026

I'm on it! enyst can track my progress at all-hands.dev

- merge latest main to resolve PR conflicts and pick up current marketplace layout
- add a usage example for TiltEffect in ANIMATION_PATTERNS.md
- update AGENTS.md marketplace registration guidance to match the current repo structure

Co-authored-by: openhands <openhands@all-hands.dev>
@enyst enyst requested a review from all-hands-bot March 22, 2026 20:50
Copy link
Collaborator Author

enyst commented Mar 22, 2026

Final pass complete for this PR:

  • addressed the remaining inline review on skills/frontend-slides/references/ANIMATION_PATTERNS.md by adding the missing TiltEffect usage example (commit 0d48163)
  • merged latest main so the branch now uses the current marketplace layout and the PR is mergeable again
  • verified the new registry state includes frontend-slides in marketplaces/default.json (with Claude compatibility following the symlinked .claude-plugin/marketplace.json)
  • ran the full test suite: uv run pytest -q22 passed
  • all review threads are now resolved

Requested the same review bot again: @all-hands-bot

@openhands-ai

This comment was marked as duplicate.

Copy link
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Acceptable

Taste Rating: Progressive disclosure is solid, code examples are complete, and previous review rounds fixed the major issues.

Verdict: ✅ Worth merging after removing the orphaned heading.

Key Insight: When you fix an issue once (orphaned headings in dark-botanical.md), grep for the same pattern everywhere. Consistency matters.

- remove the trailing '## Specialty Themes' heading from the vintage-editorial preset
- verify no other preset file ends with the same orphaned heading pattern

Co-authored-by: openhands <openhands@all-hands.dev>
@enyst enyst requested a review from all-hands-bot March 22, 2026 20:55
Copy link
Collaborator Author

enyst commented Mar 22, 2026

Addressed the latest review too:

  • removed the orphaned trailing ## Specialty Themes heading from skills/frontend-slides/references/presets/vintage-editorial.md in commit 8de6624
  • checked the other preset files for the same trailing orphan-heading pattern
  • ran uv run pytest -q22 passed
  • resolved the review thread

Re-requested the same review bot: @all-hands-bot

Copy link
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Acceptable - Progressive disclosure is solid and the skill has proven success. One DRY violation needs cleanup.

Comment on lines +17 to +25
| Slide Type | Maximum Content |
|------------|-----------------|
| Title slide | 1 heading + 1 subtitle |
| Content slide | 1 heading + 4-6 bullets (max 2 lines each) |
| Feature grid | 1 heading + 6 cards (2x3 or 3x2) |
| Code slide | 1 heading + 8-10 lines of code |
| Quote slide | 1 quote (max 3 lines) + attribution |

Too much content? Split into multiple slides. Never scroll.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟠 Important: Content density limits table duplicated with inconsistent data.

The Problem:
This exact table exists in VIEWPORT_FITTING.md (lines 15-25) but with different values:

Difference This File VIEWPORT_FITTING.md
Title slide "1 heading + 1 subtitle" "1 heading + 1 subtitle + optional tagline"
Content slide "4-6 bullets (max 2 lines each)" "4-6 bullet points OR 1 heading + 2 paragraphs"
Image slide ❌ Missing ✅ "1 heading + 1 image (max 60vh height)"

Why This Matters:
Two sources of truth with different data WILL drift over time. An agent reading both files sees conflicting guidance. Previous reviews caught and fixed the CSS duplication—this has the same root cause.

Fix:
Keep the canonical table in VIEWPORT_FITTING.md only. Replace this section with a reference:

## CRITICAL: Viewport Fitting (Non-Negotiable)

Every slide MUST fit exactly in the viewport. No scrolling within slides, ever.

**See [VIEWPORT_FITTING.md](VIEWPORT_FITTING.md) for:**
- Mandatory base CSS and responsive breakpoints
- Content density limits per slide type
- Overflow prevention checklist

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants