hq-secrets

Manage company secrets with per-secret ACLs and exec-based injection.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/indigoai-us/hq --skill hq-secrets
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hq-secrets
Source: https://github.com/indigoai-us/hq/tree/main/template/.claude/skills/hq-secrets
Command: npx skills add https://github.com/indigoai-us/hq --skill hq-secrets

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Securely manage company secrets within HQ.

Core Features & Use Cases

  • Per-secret ACLs with read/write/admin permissions and group sharing for scalable access control
  • Secrets lifecycle: list, get (metadata), get --reveal, set, delete, and share/unshare
  • Safe injection: run commands with secrets injected via exec, and export environment variables without leaking values
  • Human-centric flows: generate-link for human-provided credentials, guardrails and auditing via ACLs and groups

Quick Start

Run a quick test by injecting a secret into a command using the exec pattern.

Frequently Asked Questions about hq-secrets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage CLI secrets with group-based access control?

You can manage CLI secrets with group-based access control by utilizing per-secret ACLs. This supports read, write, and admin permissions alongside group sharing for scalable access control across your organization.

How do I inject environment variables into commands without leaking secret values?

You inject environment variables without leaking secret values by using explicit exec-based injection. This mechanism redacts values by default and requires exec workflows to safely run commands with secrets.

What is the safest way to share company secrets within a CLI environment?

The safest way to share company secrets within a CLI environment is using dedicated share and unshare commands. This enforces safe usage patterns by applying per-secret ACLs and group-based access guardrails.

Can I retrieve secret metadata without revealing the actual secret value?

Yes, you can retrieve secret metadata without revealing the value by default. The system redacts values automatically, requiring an explicit reveal command to access the underlying secret data.

How do I handle human-provided credentials securely in automated workflows?

You handle human-provided credentials securely by using a generate-link flow. This human-centric approach allows users to input credentials safely while maintaining guardrails and auditing via ACLs and groups.

What are the limitations of exec-based secret injection for CLI workflows?

A limitation of exec-based secret injection is that it requires explicit execution to prevent leakage. You cannot simply export environment variables directly; workflows must adhere to this strict exec pattern to maintain security.