Forge Actions

Forge actions are the built-in steps you use in a mold with action:. They create repositories, write files, apply template folders, set access, open pull requests, and register catalog entities.

Use this index to choose the smallest action that fits the job. For a full service scaffold, use github.template.apply. For one special file or one special commit message, use github.file.create.

Available actions

Action	Use it for	Details
`github.repo.create`	Create a GitHub repository	GitHub repositories
`github.repo.update`	Update repository settings	GitHub repositories
`github.repo.delete`	Delete a repository (destructive, not idempotent)	GitHub repositories
`github.topics.set`	Replace repository topics	GitHub repositories
`github.pr.create`	Open a pull request	GitHub repositories
`github.file.create`	Create or update one file	Files and templates
`github.template.apply`	Apply a folder of templates	Files and templates
`github.team.add`	Add team access to a repository	Repository access
`github.collaborator.add`	Add a user to a repository	Repository access
`catalog.entity.register`	Register a service in the Shoehorn catalog	Catalog registration

Form data sources

Forge mold inputs can also load options from the catalog so users pick from a dropdown instead of typing free text:

Source	Returns	Details
`catalog:teams`	Teams	Catalog-backed selectors
`catalog:users`	Users	Catalog-backed selectors
`catalog:groups`	Groups	Catalog-backed selectors
`catalog:entities`	Catalog entities	Catalog-backed selectors
`catalog:repositories`	Repositories	Catalog-backed selectors

Shared references

Expressions and context explains ${{ inputs.name }}, previous step outputs, and run metadata.
Creating Molds explains the mold YAML structure.
Developing Molds explains the local build, validation, and publishing workflow.