Skip to main content
Version: v0 (current)

Repository labels

Use this when you want to see, straight from your organization's repository list, which student repositories have questions. It needs the private answer key token.

.github/workflows/grill-my-code.yml
name: GrillMyCode

on:
  push:
    branches: ["main", "master"]
  workflow_dispatch:

# A new push cancels any run still in progress for the same branch,
# so only the latest commit is ever assessed.
# Do not modify this setting unless you have a compelling reason to.
concurrency:
  group: grillmycode-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:
  generate-questions:
    runs-on: ubuntu-latest
    timeout-minutes: 15
    permissions:
      contents: write # gmc-assessments release + PDF asset
      issues: write # assessment issue
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0 # full history required for diff resolution

      - uses: NSCC-ITC-Assessment/GrillMyCode@v0
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          api_key: ${{ secrets.OPENROUTER_API_KEY }}
          num_questions: "20"

          # The token the labels need. Also stores the private answer key.
          instructor_repo_token: ${{ secrets.INSTRUCTOR_REPO_TOKEN }}

          # Labels the repository once questions exist.
          label_repos: "true"

Change these​

  • label_repos: "true" adds the grillmycode topic, which you can filter with org:<your-org> topic:grillmycode, and appends · 🔥 GrillMyCode: N questions to the description. "false", or leaving the line out, writes nothing.

Before and after, in the organization's repository list:

cs-principles-lab-3-jsmith
Week 3 lab
cs-principles-lab-3-jsmith
Week 3 lab · 🔥 GrillMyCode: 20 questions
grillmycode

Good to know​

  • Your own topics are kept, and the description note replaces itself rather than piling up.
  • Labels stay on the repository once added, even after the assessment issue is closed.
  • GitHub shows topics in some list views and not others; check it appears where you look.
  • No setup needed at all: org:<your-org> is:issue is:open label:assessment lists repositories with live questions.

Tracking assessed repositories · Repository label internals