GitHub Actions Workflow Specification

# GitHub Actions Workflow Specification

Read one existing GitHub Actions workflow and produce an evidence-linked specification of its behavior and maintenance contract.

## Required Aident Actions

- <action-tag>composio:github_tools:github_get_repository_content</action-tag> (required inputs: path, repo, owner): Retrieves a file's Base64 encoded content or lists a directory's contents from a GitHub repository.

Use Aident Loadout to read the current Action schema before constructing inputs. Check the required integration connection in Aident Vault. If an Action is billable or mutating, run Aident preflight, show the affected target and quoted cost or risk, and wait for explicit user confirmation before execution.

## Workflow

1. Confirm the requested outcome, source material, destination, audience, constraints, and acceptance criteria.
2. Apply the source-derived guidance below to create a concrete plan. Resolve ambiguity before invoking an Action.
3. Select only the Aident Actions whose documented effect directly advances the requested outcome. Do not invoke every listed Action by default.
4. Inspect the current schema and prepare the minimum valid input for each selected Action.
5. Preflight each selected Action. Execute it only after any required confirmation, in dependency order, and carry returned IDs or asset URLs into later steps.
6. Verify the returned IDs, URLs, statuses, or artifacts against the acceptance criteria. Report partial completion precisely and do not repeat paid or mutating calls blindly.

## Source-Derived Guidance

- Confirm the repository, ref, and exact workflow path under .github/workflows before reading content.
- Use composio:github_tools:github_get_repository_content to retrieve the selected YAML workflow from the reviewed ref.
- Document triggers, permissions, concurrency, jobs, dependencies, conditions, matrices, environments, artifacts, and referenced secret names from the returned workflow.
- Trace every statement to the workflow content, distinguish reusable-workflow or action dependencies that were not expanded, and never claim access to secret values.
- Return a non-mutating specification and unresolved questions; do not claim that the workflow was validated, executed, or changed.

## Execution Boundaries

- Treat upstream provider-specific commands as background knowledge only. Execute the workflow through the exact Aident Actions above.
- Never request raw credentials in chat. Use Aident Vault connection flows for required accounts.
- Preserve user-provided wording, brand constraints, rights restrictions, and target identifiers. Do not invent authorization.
- Read current state before a mutation, state the exact target, and include a rollback or recovery step in the result.
- Stop when a required integration is disconnected, preflight rejects the input, the target is ambiguous, or the user declines a required confirmation.

## Output

Return the execution plan, selected Action names, confirmed targets, Aident result identifiers or asset URLs, verification evidence, and any remaining blocked step.

## Attribution

This Skill adapts the reviewed upstream workflow. See [UPSTREAM.md](UPSTREAM.md) for the pinned source and [LICENSE.txt](LICENSE.txt) for the preserved license.