Skip to content

feat(skills): add getting-started-with-openshell skill for prospective contributors - #5286

Draft
purp wants to merge 2 commits into
NVIDIA:mainfrom
purp:feat/5284-getting-started-skill/purp
Draft

purp wants to merge 2 commits into
NVIDIA:mainfrom
purp:feat/5284-getting-started-skill/purp

Conversation

@purp

@purp purp commented Nov 4, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Adds a lightweight contributor skill, getting-started-with-openshell. It makes the answer to "How do I get started?" fork, open your agent, and run /getting-started-with-openshell. The skill asks about the person's interest and walks them through hands-on use. It points them toward the community and first issues only after they show real engagement.

Related Issue

Closes #5284

Changes

  • New .agents/skills/getting-started-with-openshell/SKILL.md (metadata.internal: true). It runs in four phases: learn the person's interest, build and learn, assess engagement, and point toward involvement. The phase 1 questions decide what the person learns first; they are not a screen.
  • Involvement starts with CNCF Slack (invite at https://slack.cncf.io) and the community call, which people join through the OpenShell Community Google Group. It does not start with Discussions.
  • Once someone shows real engagement, the skill can help draft a vouch request. The draft uses only the person's own answers and what they did hands-on. They rewrite it in their own voice and post it themselves.
  • Suggested first PR, called a contributor's badge: a good first issue implemented by an agent running inside an OpenShell sandbox, with OCSF log excerpts from that session as evidence.
  • The skill takes no GitHub write actions.
  • CONTRIBUTING.md:
    • First-Time Contributors points newcomers to the skill.
    • The contributor skills table lists the skill.
    • Both mentions of CNCF Slack now link to the inviter.
    • Vouch rule change: step 3 changes from "AI-generated vouch requests will be denied" to "based on your own use of OpenShell; an agent may help you organize it, but generic requests or ones that don't reflect your experience will be denied."

Open questions for reviewers

Testing

  • mise run markdown:lint passes (.agents/ is excluded from markdownlint)
  • Relative links and anchors in the skill resolve. The published docs, Slack inviter, Google Group, and Discussions URLs return 200.
  • Unit tests added/updated (not applicable)
  • E2E tests added/updated (not applicable)

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)

…e contributors

Guides a newcomer from stated interest to hands-on use of OpenShell, and
toward Discussions, Slack, a vouch request, and good first issues only
once they show real engagement. Takes no GitHub write actions.

Refs NVIDIA#5284

Signed-off-by: Jim Meyer <jimeyer@nvidia.com>
@copy-pr-bot

copy-pr-bot Bot commented Nov 4, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

…ounded vouch drafts

Point newcomers to CNCF Slack (slack.cncf.io) and the community call
instead of Discussions. Allow the skill to help draft a vouch request
built only from the person's own answers and hands-on usage, and align
the CONTRIBUTING vouch guidance with that. Rename the first-PR evidence
to a contributor's badge.

Refs NVIDIA#5284

Signed-off-by: Jim Meyer <jimeyer@nvidia.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(skills): add a getting-started-with-openshell skill for prospective contributors

1 participant