agentleFS
robertbradley-ossrobertbradley-oss/skills/feedback-to-findings/SKILL.md

feedback-to-findings

Skill2 starsChanged 2 months agoMITView on GitHub

Synthesize supplied reviews, tickets, surveys, or interview notes into traceable themes and evidence-backed findings. Use for analysis of existing feedback, not recruiting participants or generating fictional research.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before reporting frequency, distinguish repeated messages from independent people and repeated reports of the same incident.

    line 22

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Feedback to findings

Explain what the available feedback supports, who it describes, and what remains uncertain. Keep source observations distinguishable from interpretations and proposed responses.

Establish coverage

Identify the question, source set, dates, sampling method if known, and unit of analysis: messages, incidents, respondents, or accounts. Use existing context and ask only for gaps that change the interpretation. If no feedback is available, ask for it rather than inventing themes.

Preserve source identifiers and locations while avoiding unnecessary personal details in the report. Keep original material intact. Note partial exports, missing segments, selection effects, and sources that cover different populations or periods.

Extract and group

Extract concrete observations and requests with enough context to retain their meaning. Use short faithful excerpts or clearly labeled paraphrases. A requested feature is evidence of a request; its underlying need is an interpretation until supported by context.

Group observations by shared problem or situation, allowing a record to support multiple themes. Preserve minority views, positive experiences, exceptions, and counterexamples. Do not merge conflicting experiences into a false consensus. Separate a person's experience from their speculation about everyone else.

Before reporting frequency, distinguish repeated messages from independent people and repeated reports of the same incident. Deduplicate only with a defensible rule; similar wording alone does not establish the same person. If identity is unknown, count records and disclose that unique respondents cannot be established.

Use explicit denominators for rates. Multi-label theme percentages may overlap and need not sum to 100%. Do not infer population prevalence from a convenience sample or treat silence as satisfaction. Keep severity, frequency, and confidence separate: a rare consequential issue can matter more than a common inconvenience.

Develop findings

For important themes, explain the pattern, affected context, supporting sources, contradictory evidence, and practical implication. Keep confidence tied to evidence quality and coverage instead of arbitrary numerical scores.

Separate observed behavior, reported experience, inferred need, and suggested action. Rank findings by the requested decision and supported impact, not solely mention counts. Avoid claiming that a proposed solution has been validated by feedback about a problem.

Deliver

Provide a concise synthesis with traceable examples and material coverage limits. Use a compact evidence table when volume warrants one. Identify specific follow-up questions or checks where they could change a decision. If evidence is thin, report a provisional pattern or no supported pattern rather than manufacturing findings. Contacting participants, creating tickets, or editing source systems requires authorization beyond synthesis.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.