Nutrition Alignment Skill: Runtime-Governed Agent Harness for User-Owned Structured Data

0 0 Updated: 2026-07-28 18:08:52

A runtime-governed agent harness for managing user-owned structured data, originally built for personal health data. It provides nutrition alignment capabilities, enforcing contracts at runtime via GovernanceAgentBench, a benchmark that separates in-context contracts from runtime enforcement. Ideal for healthcare data governance scenarios.

Install
npx skills add https://github.com/dtcolligan/health_agent_infra.git --skill nutrition-alignment
Skill Details readonly

Discussing Nutrition Alignment Skills: When Personal Health Data Meets Runtime Governance

Seriously, I've been looking into something pretty interesting lately — Nutrition Alignment Skills. At first glance, the name sounds like it's about food, but it's actually an agent tool focused on data governance, specifically for managing your own structured data, particularly personal health data. For example, you log what you eat, how long you exercise, and how well you sleep every day. This data belongs to you, and this skill helps you add a layer of "runtime governance," essentially setting up a door lock for your data — allowing only authorized agents to access it according to your rules.

When I first saw this project on GitHub, I thought it was one of those complex academic research pieces. But after reading the description, I realized it's actually quite practical. In particular, it comes with a benchmarking tool called GovernedAgentBench, which separates "context contracts" from "runtime execution." In other words, you can define rules in the contract, but when it actually runs, it dynamically checks them rather than rigidly applying templates.

What Problems Does It Solve?

Imagine you're a health app developer, and users authorize you to access their diet records. The traditional approach is to store a permission table, but Nutrition Alignment Skills takes a more flexible route: you can define a series of runtime contracts, such as "only read dinner data between 8 PM and 10 PM" or "must encrypt data before writing." The contracts take effect in real-time for each operation, and since data ownership always remains with the user, even if an agent goes rogue, the data won't be stolen. Sounds a bit like installing a smart lock on your data, doesn't it?

Better yet, this skill comes with its own benchmarking tool. You can write different contract strategies and then run them through GovernedAgentBench to see which strategy strikes the best balance between performance and security. For instance, you can test a "strict encryption strategy" versus a "loose access strategy," and it will automatically generate a report telling you the overhead of each.

Installation Steps: So Simple It's Laughable

Honestly, the installation process is one of the simplest I've ever seen. Prerequisites: you need Node.js and npm. Then open a terminal and run just one command:

npx skills add https://github.com/dtcolligan/health_agent_infra.git --skill nutrition-alignment

If you're using this skill for the first time, you might also need to install the skills CLI tool: npm install -g @user/skills. But npx handles it automatically — you can just run the command above, and it will download the whole skill package for you.

After installation, type npx skills list to see the skill name. Running it is even simpler:

npx skills run nutrition-alignment

It has a wizard interface. On the first run, it will ask you to configure the data source, such as specifying a JSON file as your health database. After that, you can operate through commands:

  • Create a contract: npx skills call nutrition-alignment create-contract --data myhealth.json
  • Enforce governance: npx skills call nutrition-alignment enforce --policy policy.yaml
  • Run a benchmark: npx skills call nutrition-alignment benchmark --iterations 10

Note: In the policy.yaml file, you can define various rules, such as "only allow reading data from the last 7 days" or "require double signatures for writing." For specific syntax, refer to the project's SKILL.md file, which should contain examples.

User Experience Ramblings

I encountered a snag during testing: if you don't have Git installed, the npx add command will throw an error because the skill package needs to be pulled from a GitHub repository. So you need to have Git installed beforehand. Also, if you're on Windows, I recommend using PowerShell or Git Bash to run commands — CMD might have character encoding issues (don't ask how I know; it was frustrating).

Additionally, the skill configures the runtime governance environment in the ~/.skills directory by default. If you want to clean up the data, just delete that folder. But note that if you have important contracts, you'd better export them first.

Practical Application Examples

Suppose you're a nutritionist and you want to create a diet tracking mini-app for your clients. You can use this skill to manage each client's data access permissions. Clients upload photos of their meals, and your agent can only read them during the approved time windows. Another example: if you're building a medical research data lake and need to ensure that different research institutions only access the data subsets they're authorized for — Nutrition Alignment Skills can be a great fit.

And because it's runtime governance, policies can be hot-updated without shutting down the entire system. If regulations change, you just modify the contract file and reload it, and all subsequent operations will automatically follow the new rules.

Overall, if you're looking for a solution that protects user data privacy while allowing flexible permission control at runtime, this Nutrition Alignment Skill is definitely worth trying. I'm still exploring the specific usage of GovernedAgentBench, and I'll share more insights later.