Skip to content

.agents/skills/gog/SKILL.md contains stale repo references (docs/README.md, README#security, internal/auth/) #557

@WadydX

Description

@WadydX

Summary

.agents/skills/gog/SKILL.md contains stale repo references that point agents to files/directories that do not exist anymore.

Evidence

Current references in .agents/skills/gog/SKILL.md:

  • docs/README.md
  • README.md#security
  • internal/auth/

From the current repo layout:

  • docs/README.md does not exist
    • there is docs/index.md
  • README.md#security does not appear to exist
  • internal/auth/ does not exist
    • related current directories include internal/googleauth/, internal/authclient/, and internal/secrets/

Relevant lines in the skill today are the docs/repo-path guidance section near the bottom of .agents/skills/gog/SKILL.md.

Expected behavior

The bundled agent skill should point to valid repo docs and source directories so agents can navigate the codebase correctly.

Actual behavior

The skill contains dead/stale references, which can send agents to nonexistent paths and degrade repo-specific guidance.

Why it matters

This repo explicitly ships agent-facing guidance, so stale path references are not just cosmetic:

  • they waste time during repo inspection
  • they make agent outputs less reliable
  • they create drift between the documented architecture and the actual repo structure

Suggested fix

Update .agents/skills/gog/SKILL.md to reference the current paths, for example:

  • replace docs/README.md with the current docs entrypoint
  • either add a real README security section or remove/replace README.md#security
  • replace internal/auth/ with the current auth-related packages actually used by the repo

Environment

  • gogcli repo content from current main
  • static inspection only; no runtime claims

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions