Skip to content

feat: add gemara-bundle skill for bundle manifest creation - #7

Open
sonupreetam wants to merge 1 commit into
gemaraproj:mainfrom
sonupreetam:feat/gemara-bundle-skill
Open

feat: add gemara-bundle skill for bundle manifest creation#7
sonupreetam wants to merge 1 commit into
gemaraproj:mainfrom
sonupreetam:feat/gemara-bundle-skill

Conversation

@sonupreetam

@sonupreetam sonupreetam commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds skills/gemara-bundle/SKILL.md — guides LLMs through creating bundle manifests with correct format
  • Prevents a common LLM hallucination where object-style entries (- path: ...) are used instead of plain strings (- ...), which breaks the publish workflow's discover step
  • Follows the same SKILL.md pattern as feat: adds claude plugin for gemara mcp and skills #6 (frontmatter, prerequisite scan, wizard steps, format rules)

Naming

The skill uses the gemara- prefix for consistency with other skills in this plugin (gemara-policy, gemara-artifact-authoring, etc.), even though bundle manifests do not have a corresponding CUE schema definition — they are a CI convention for the publish workflow.

Context

Observed CI failure in an exercise repo where the LLM generated:

layers:
  - path: governance/policies/container-security.yaml

instead of:

layers:
  - governance/policies/container-security.yaml

The bundle manifest is a CI convention (not a Gemara schema type), so it doesn't belong in gemara-mcp. This skill provides the "last mile" context after artifacts are authored — wiring them for OCI publishing.

Depends on

Guides LLMs through creating bundle manifests with correct plain-path
format, layer ordering, and file existence verification. Prevents common
LLM hallucination of object-style entries (e.g. '- path: ...') that
break the publish workflow's discover step.

Signed-off-by: sonupreetam <spreetam@redhat.com>
@sonupreetam
sonupreetam force-pushed the feat/gemara-bundle-skill branch from 79e9819 to e63f755 Compare July 31, 2026 10:53
@sonupreetam
sonupreetam marked this pull request as ready for review July 31, 2026 11:09
@sonupreetam

Copy link
Copy Markdown
Contributor Author

As PR #6 is merged, @hbraswelrh & @jpower432, this PR is ready for review. This from the UAT testing to prevent LLM hallucination.

@jpower432
jpower432 requested a review from hbraswelrh August 7, 2026 14:24

@slegarraga slegarraga left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The skill reads well and the core rule is clear: plain string paths, no key-value entries, relative to the repo root, and the last entry is the root artifact. That directly addresses the hallucination failure described in the PR. One optional follow-up would be linking to an existing bundle manifest or the discover step so the contract is discoverable from the skill itself. No blocking issues from my side.

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.

2 participants