Skip to content

docs(skills): instruct agents to run hyperframes feedback after render#1785

Open
miguel-heygen wants to merge 2 commits into
mainfrom
skill/cli-feedback-instruction
Open

docs(skills): instruct agents to run hyperframes feedback after render#1785
miguel-heygen wants to merge 2 commits into
mainfrom
skill/cli-feedback-instruction

Conversation

@miguel-heygen

Copy link
Copy Markdown
Collaborator

Why

The feedback dashboard shows only ~15 responses since the feature shipped. Root cause isn't the CLI — hyperframes feedback --rating --comment exists, and the post-render flow already prints an agent hint when it detects an agent runtime. But no skill ever told agents to act on it, so agents see a dim stdout line in the render output and move on. The agent feedback channel — where most renders actually happen — is silent by default.

What

Add the feedback instruction to the three paths agents actually read in the hyperframes-cli skill:

  • Workflow step 8 — feedback now follows render in the numbered dev loop.
  • Agent Conventions bullet — the standing instruction, right after post-render verification.
  • preview-render.md ### feedback subsection — full usage detail with a realistic example comment.

skills-manifest.json regenerated by the pre-commit hook.

Note

This lives in skills/ source. Agents run against the installed skill set (pulled on init), so it reaches them once merged and served by the skills registry. No code change — the CLI plumbing already works; this just gives agents the standing order to use it.

The `hyperframes feedback` CLI command and the post-render agent hint
already exist, but no skill told agents to act on it — so the feedback
channel is starved (agents see a dim stdout line and move on). Add the
instruction to the three paths agents actually read in the hyperframes-cli
skill: workflow step 8, an Agent Conventions bullet, and a dedicated
`feedback` subsection in the preview-render reference.
…struction

# Conflicts:
#	skills-manifest.json
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.

1 participant