hephaestus-network
Use when the user types $hephaestus-network, /hep-network, or /agentlas-network, mentions @Hephaestus, or asks Agentlas to staff a durable goal from registered Local, owner Cloud, and public Hub agents or teams.
Install / Use
npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-networkInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AI & Machine LearningSupported Platforms
Tags
Our assessment of hephaestus-network
hephaestus-network scores 91/100 on our quality scale, 332nd of 947 AI & Machine Learning skills we index (top 36%).
Its SKILL.md is 20 KB long, well organised into 10 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 1,087 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so hephaestus-network is actively maintained.
- Our last check on 2026-10-29 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
hephaestus-network compared with similar skills
All 4 of these similar skills score higher than hephaestus-network; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| hephaestus-network (this skill)by agentlas-ai | 91 | 1.1k | 53d ago | SKILL.md |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install hephaestus-network?
- Run
npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-network. The install tabs above show the steps for each supported agent. - Which AI agents does hephaestus-network work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is hephaestus-network safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is hephaestus-network still maintained?
- The repository was last updated about 2 months ago, so hephaestus-network is actively maintained.
Skill content
View source on GitHubname: hephaestus-network description: "Use when the user types $hephaestus-network, /hep-network, or /agentlas-network, mentions @Hephaestus, or asks Agentlas to staff a durable goal from registered Local, owner Cloud, and public Hub agents or teams. The active host LLM staffs each turn; the exact roster remains goal-bound until explicit completion."
Hephaestus Agent Workforce Network
The active host LLM staffs the task. Agentlas Core federates content menus from registered Local, owner Cloud, and public Hub inventory. No source and no deterministic layer is the decision-maker or a server-side LLM executor.
Source scopes are exact:
network: Local + Cloud + Hub;local: registered Local packages only;cloud: the signed-in owner's Cloud packages only;hub: public Hub packages only.
Before an unpinned search uses the Local source, Core refreshes every active
registered source folder and creates a new immutable release when its safe
content snapshot changed. This is discovery freshness; a prepared or
goal-bound roster remains pinned to its exact release. network reindex is a
rebuildable card-cache operation and is not required to refresh a registered
Local release. New folders still require explicit local-register.
Public demos and distribution proof use explicit hub scope. They must not use
private Local/Cloud inventory as evidence of public availability.
Resolve the runner and sign in
Network can query owner Cloud and public Hub inventory, so establish the same saved Agentlas session before staffing:
RUNNER=""
for c in \
"$HOME/.agentlas/runtime/current/bin/hephaestus" \
./bin/hephaestus
do [ -x "$c" ] && RUNNER="$c" && break; done
if [ -z "$RUNNER" ]; then
for cache in \
"$HOME/.claude/plugins/cache/agentlas-core-engine/hephaestus" \
"$HOME/.codex/plugins/cache/agentlas-core-engine/hephaestus"; do
newest="$(ls -d "$cache"/*/bin/hephaestus 2>/dev/null | sort -V | tail -1)"
[ -n "$newest" ] && [ -x "$newest" ] && RUNNER="$newest" && break
done
fi
if [ -n "$RUNNER" ] && [ "${HEPHAESTUS_AUTH_AUTOPOPUP:-1}" != "0" ]; then
"$RUNNER" auth ensure >/dev/null 2>&1 || true
fi
The browser opens only when no reusable local sign-in exists. In CI or another
headless environment, set HEPHAESTUS_AUTH_AUTOPOPUP=0.
Required MCP sequence
First confirm the typed tool menu contains workforce.preflight_work_order and
that its _meta.protocolVersion is at least 2026-08-20.1. If the tool is
absent, the host is still attached to a preflight-less runtime. Do not fall back
to model-authoring the strict wire WorkOrder and do not retry the same invalid
call. Return the machine-readable boundary
workforce_protocol_upgrade_required; let the runtime's normal verified
auto-update finish, then reload the host/MCP session. An explicit
hephaestus hep-update remains an operator action, never an implicit skill
side effect.
"Absent" must be proven against the host's real tool names, not a guessed
spelling. Hosts rewrite MCP tool names: the server is hephaestus-network, and
Codex, for example, exposes workforce.preflight_work_order as
mcp__hephaestus_network__workforce_preflight_work_order (the dot becomes one
underscore; the prefix is the server name, not agentlas). Before returning
workforce_protocol_upgrade_required, search the tool menu for every name
containing preflight_work_order and goal_context. If any match exists, the
tool is present — call it. If other hephaestus-network tools (for example
context_slice) are present but these two are not, report both facts; that is
not proof of an old runtime. Measured 2026-09-24: a Codex session probed the
invented mcp__agentlas__workforce__goal_context, found nothing, and halted
staffing while runtime 1.2.49 was serving both tools.
Use the Agentlas Core Workforce contracts in this order:
workforce.preflight_work_order(taskBrief=..., roles=..., edges=...)
workforce.search_candidates(workOrderRef=..., sourceScope="network")
workforce.expand_candidates(selectionSessionId=..., candidates=[{slotId, candidateOrdinal}])
workforce.validate_selection(decision={selectionSessionId, decisionAuthor, assignments})
workforce.prepare_execution(selection=..., federatedSelectionDigest=..., projectDir=..., goalId=activeGoalId?, fullDossier=false)
workforce.validate_execution_receipt(receipt=..., executionPlan=..., toolInventory=...)
Call these exact typed tools directly. Do not enumerate, serialize, print, or
search the host's complete ALL_TOOLS registry: the sequence and tool names are
already specified here, and dumping unrelated schemas spends context without
improving staffing.
The source-internal workforce.fetch_runtime_bundle call is performed by Core
from the pinned original source session/digest. The host must not call it
directly or replace it with a slug/latest lookup.
The default search response is a projected decision menu. Preserve its source
receipts and selectionSessionId, but do not echo that projection as
federationResult; Core resolves and revalidates the full pinned result by
session. The final receipt call is local, bounded, and read-only. It validates
host-produced evidence and never executes workers or creates a receipt.
The current CLI equivalent is workforce search --scope network. A host adapter
that does not yet expose typed sourceScope must report that wiring gap; it
must not silently call public Hub-only search and label it Network. Do not call
the legacy lexical router first. Do not turn install count, ratings, invocation
history, source precedence, or a deterministic top score into the staffing
decision. If a source is unavailable, preserve its finite failure receipt.
1. Perform job analysis
Act as the active top-level orchestrator. Convert the user's task into one
compact semantic draft for workforce.preflight_work_order. Core compiles it
into the exact redacted agentlas.workforce-work-order.v1, generates finite
WorkOrder/slot/artifact identifiers, fills omitted empty arrays, pins the
ontology version, validates the privacy boundary, and returns a one-hour
workOrderRef. Keep raw local files, secrets, memory, and private prompt details
on the host. Create one roles entry per materially distinct responsibility.
Each role may identify:
- semantic role/community and required skill or knowledge concepts, written as plain
English phrases when no ontology id is obvious — Core normalizes them into
schema-valid concept ids and reports every rewrite as
normalizedConcepts. Only these semantic communities, roles, skills, and knowledge may narrow menu fit; - execution requirements such as required MCP/tool capabilities, runtime, language, modality, and required/forbidden authority. Include these only when the requested action genuinely needs host proof. They never filter, rank, or exclude semantic candidates; Core carries them into the ExecutionContext and the host validates them against its actual tool inventory, capability binding plan, permission policy, and invocation receipt after selection;
- collaboration edges by 1-based role ordinal. An edge is a declaration of handoff, never a qualification requirement. Requiring an artifact almost no published agent declares does not narrow a menu, it empties it;
- executable entity-kind constraints;
- cardinality, criticality, and collaboration edges;
- the minimum evidence level: declared, checked, demonstrated, or attested.
Do not create decorative roles. A single specialist is valid for a genuinely
single-role task; a composite task should become a real temporary task force.
Executable slots allow only agent or team; group is discovery-only until
an authoritative group execution contract exists.
Omit unconstrained runtime, authority, language, and modality arrays. Never
invent prefixed finite values such as language:ko or custom slot/artifact IDs;
the draft schema exposes the finite values and Core owns mechanical IDs. Use the
default candidate policy (2 minimum, 30 maximum per role) unless the task has a
concrete recall reason to widen it. Protocol receipt verification is already an
independent gate, so do not add a decorative verifier role merely to restate it.
The user never has to write the word goal or enable a goal mode. Before a new
search, call workforce.goal_context for the current project. If an active
binding is the same ongoing work, treat its goalId and roster as incumbent.
Only create a new WorkOrder when no active binding covers the work or the
incumbent has a real gap.
2. Retrieve the menu, then make the LLM decision
Before calling any remote source, call workforce.preflight_work_order. Its
deterministic compiler and WorkOrder boundary cover every schema-declared string
and structured identifier, including nested roles, skills, tools, authorities,
artifacts, edges, runtime/language, and policy fields—not only prose fields. A
path, personal/account identifier,
credential URL, private concept identifier, or secret-like value returns only
path/class repair evidence with hubCalls=0 and a null rejected-object digest;
never trust a draft's prose, echo the rejected value, or compute/display a
digest over rejected data. Ask Core for sourceScope="network" with the returned
workOrderRef only after that boundary accepts. Do not echo the compiled
WorkOrder. Each source returns a bounded shortlist by default; narrow it, then
use workforce.expand_candidates only for the candidates worth a full-card
comparison. Each source's complete menu remains pinned in Core;
Core validates and unions them using canonical identity ordering. It performs
no semantic rerank. Read the exact roles,
skills, MCP tools, inputs/outputs, authority, eval evidence, communities,
release version, package hash, content digest, source receipt, and provenance.
Source precedence is not ranking. It applies only when the same
agentDefinitionId has verified identical lineage issuer/digest and the exact
same release version, package hash, content digest, and entity kind at multiple
sources. Then and only then shadow Local > Cloud > Hub. Similar names/slugs are
never deduplicated. Missing lineage or different releases fail closed for that
collided identity: Core quarantines the ambiguous definition and preserves
unrelated Local/Cloud/Hub candidates with finite aggregate conflict evidence.
You, the active host LLM, choose the ideal roster. Consider complementary
coverage and handoffs, not a scalar top-1 score. Return
agentlas.workforce-selection.v1 with decisionAuthor.kind = "host_llm", the
real host model id, exact slot/release assignments, graph edges, alternatives,
and short reason codes. Some nondeterminism in final judgment is intentional;
hard constraints are not.
If a required slot has inadequate coverage, use at most two same-host semantic
WorkOrder refinements across the whole decision. A provisional Selection may
request content expansion through requestExpansionForSlots; the adapter gives
the host only aggregate slot/count/gap data, never candidate identities. Never
fill a post with a semantically unrelated agent or repeat an exhausted request.
3. Validate and pin exact releases
Send the compact decision — selectionSessionId, decisionAuthor, and one
assignments row per post naming the candidate by its menu candidateOrdinal
with reason codes. Core resolves the pinned WorkOrder, federated CandidateSet
and federation receipt from that session, fills the candidate-set digest and the
arrays that are empty in a normal decision, and compiles the exact
agentlas.workforce-selection.v1. Re-plan on rejection. The validator may
reject constraints, cardinality, cycles, drift, out-of-menu releases, or a
source-pin mismatch; it must never pick for you.
An accepted receipt can still carry unmetRequirementCount. That is not a
rejection and Core will not choose for you, but it is not noise either: read
`selection
Truncated for display — read the full file on GitHub.
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
