Add dbhq-uk/heliograph-skill to community agent skills - #104
Open
grinidx wants to merge 1 commit into
Open
Conversation
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.



Adds
dbhq-uk/heliograph-skillunder Community Discovery and Skills.The operational use case. Debugging a host the agent cannot reach at all: air-gapped, client-owned or change-controlled estates where only the customer's own staff can log in. It is not another investigator agent - it is the transport and capture layer for when SSH is off the table. Steps go out over a private git repo, an on-site operator runs one command that never changes (or starts an unattended runner), and the whole run comes back as a committed log. Every line carries a UTC timestamp, so a hang shows up as a gap rather than being indistinguishable from slow progress, and the log is pushed with its exit code even when the step fails.
Classification, and why.
action_levelwrite-capablehuman_approvaltruerisk_notes: the optional unattended runner executes whatever is pushed to the branch it watches, so per-step review only holds in the manual modeevidence_tracingyesmaturityprototypeAgainst the operator safety checklist. No credentials of any kind: no cloud auth, no API keys, no tokens beyond the git remote. Nothing to give the agent, so it can be evaluated with no real cloud credentials at all -
bootstrap.shinto a scratch repo and run./run.sh envagainst any box you already have. Blast radius is whatever account the operator runs it as, which is stated inrisk_notes. Secrets handling is the one real caveat and it is documented in the skill's ownSECURITY.mdas well as here: logs are committed, so anything a command prints lands in git history permanently.cap_redactmasks the common shapes on the way out and the README says plainly that this is a safety net, not a guarantee.It does not tunnel, proxy or hold a connection open. The only thing that crosses the gap is a git commit, run by someone who already has legitimate access.
Checklist
community-agent-skills, an existing catalog slug.type: skill, an existing validator-backed artifact kind.risk_notesexplains what could go wrong.operator_noteexplains why an infrastructure operator should care.prototype,approval,evidence,write. Noprod/prototypecombination;writepaired withwrite-capable;evidencepaired withevidence_tracing: yes.data/repos.yamlandREADME.mdboth updated, plusdata/catalog.jsonand the README counts viascripts/sync_catalog_json.pyandscripts/sync_readme_counts.py.python3 scripts/validate_repos_yaml.pypasses (81 entries);pytestpasses (149 tests).Disclosure: I am the author.