Environment Variables

Configure secrets and environment variables for your SkillReg skills. Manage sensitive data securely across development and production.

Overview

Skills can declare environment variables (API keys, database URLs, configuration values) in their SKILL.md frontmatter. The CLI manages these securely on your local machine, injecting them into skills at install time.

Set Variables

Use skillreg env set to define one or more environment variables for a skill. Values are provided in KEY=value format.

$ skillreg env set my-skill API_KEY=sk-123 DB_URL=postgres://localhost:5432/app

  Set 2 variable(s) for my-skill

List Variables

View configured environment variables. Without a skill name, you get a summary of all skills with env var counts. With a skill name, you see each variable with its value partially masked.

$ skillreg env list

  SKILL              VARIABLES
  my-skill           2
  deploy-k8s         3
  code-review        1

$ skillreg env list my-skill

  KEY         VALUE
  API_KEY     sk-1****
  DB_URL      post****

Delete Variables

Remove specific environment variables from a skill. Pass one or more key names to delete.

$ skillreg env delete my-skill DB_URL

  Deleted 1 variable(s) from my-skill

How Env Injection Works

When you run skillreg pull, the CLI handles environment variables automatically through the following process:

• Reads the env declarations from the skill's SKILL.md frontmatter
• Prompts you interactively for any missing values (interactive wizard)
• Injects the values into the installed SKILL.md as HTML comments
• Replaces ${VARIABLE} placeholders in the skill content with actual values