Documentation

Feedback and reviews

Request features, report issues with the failed request attached, vote, comment and review, from the board, the API, MCP and the CLI; every email it sends.

The board

The feedback board is shared by every organisation on Skillhook Cloud. Feature requests are public; issues are private to the organisation that reported them and the Skillhook team, until the team publishes a sanitised title others can "me too". The board never shows an address, an organisation or an issue's context: authors appear by first name, or as "A Skillhook user".

An item moves from open to planned, in progress and done, or ends declined or duplicate (its votes and subscribers move to the item it joins). Each change is in the item's timeline with the team's note. One vote per organisation; voting subscribes you, and taking the vote back unsubscribes you unless you filed it or commented. Problem reports filed from the dashboard's Support page, the API or a machine (skillhook cloud report) are items too.

Every action, everywhere

The board, the API, the MCP server and the CLI do the same things. Filing looks for similar items first: request_feature and report_issue answer created: false with similar items to upvote instead, and force: true files anyway.

ActionMCP toolCLIREST
Search the boardlist_feedbackskillhook feedback listGET /api/v1/feedback (no key needed)
One item, its comments and timelineget_feedbackskillhook feedback show <number>GET /api/v1/feedback/{item}
What my organisation filed and followslist_my_feedbackskillhook feedback mineGET /api/v1/feedback?mine=true
Request a featurerequest_featureskillhook feedback request "<title>"POST /api/v1/feedback/features
Report an issuereport_issueskillhook feedback report "<title>" [--request-id] [--job] [--last]POST /api/v1/feedback/issues
Upvote, or take it backupvote_feedback / remove_feedback_voteskillhook feedback upvote <number> [--remove]POST / DELETE /api/v1/feedback/{item}/votes
Commentcomment_on_feedbackskillhook feedback comment <number> "<text>"POST /api/v1/feedback/{item}/comments
Post or edit a reviewsubmit_reviewskillhook review --rating 5 --likes … --dislikes …PUT /api/v1/reviews/me
Read reviewslist_reviewsskillhook reviewsGET /api/v1/reviews (no key needed)

Reporting an issue with the request attached

Every API answer carries an x-request-id. Pass it as request_id, with what you know as context (versions, error codes, ids; up to 64 KiB of JSON, never public) and the machine, job or delivery it concerns. skillhook feedback report --last attaches the last failed call of the CLI by itself; --job attaches a job and its machine.

POST/api/v1/feedback/issues
API key · fleet:read

Reviews

One review per organisation (the reviews page), posted by a member or an admin: a rating from 1 to 5 and, if you like, a title, what you like and would change, your use case, the name and company to show, and whether we may quote it. It is published at once unless an automated check holds it for the team (language, links, an account less than a day old that never paid). Edits keep the earlier version. Agents post only what the person said, never a rating of their own.

Emails

Every one thanks you, names the item, links to it and says what happens next. They come from support@skillhook.dev; replying reaches the team. Turn them off with the link in any of them (one click, for that address) or under Email preferences; product emails and the digest are separate. At most 20 feedback emails reach one address a day.

WhenToWhat
A feature requestedits authorThanks for the idea, with a link to the board
An issue reportedits author (and the team)We got your report, with the context it carries; the team gets the report with Reply-To you
A votethe voterThanks for voting; at most one a day, later votes fold into the next
A comment by someone elsethe authorA digest, at most one a day
An official responseeveryone subscribedThe team's reply
Planned, in progresseveryone subscribedThe new status with the team's note
Doneeveryone subscribedThank you, with what changed and how to use it
Declined, duplicateeveryone subscribedWhy, or the item it was merged into (your vote moves there)
A review posted, answeredthe reviewerThanks for reviewing; we replied