[davidkunz]

Please standardize the folder.

  .claude/skills
  .codex/skills
  .opencode/skills
  .github/skills

[albert_e]

This is happening as we speak.

Codex started this and OpenCode followed suit with the hour.

https://x.com/embirico/status/2018415923930206718

[PantaloonFlames]

“Proposal: include a standard folder where agent skills should be“

https://github.com/agentskills/agentskills/issues/15

[wernerb]

Could we adhere to the XDG standard and put config in ~/config/agents Or perhaps create a new XDG standard? Like $XDG_AGENTS_HOME ?

[prettyblocks]

I find that even though this isn't standard, that these -cli tools will scan the repo for .md files and for the most part execute the skills accordingly. Having said that, I would much prefer standards not just for this, but for plugins as well.

[iainmerrick]

Standards for plugins makes sense, because you're establishing a protocol that both sides need to follow to be able to work together.

But I don't see why you need a strict standard for "an informal description of how to do a particular task". I say "informal" because it's necessarily written in prose -- if it were formal, it'd be a shell script.

[m4r71n]

That is being discussed in https://github.com/agentskills/agentskills/issues/15.

[mijoharas]

I mean, it'd be good if these tools followed the xdg base spec and put their config in `~/.config/claude` e.t.c instead of `~/.claude`.

It's one of my biggest pet peeves with a lot of these tools (now admittedly a lot of them have a config env var to override, but it'd be nice if they just did the right thing automatically).

[verdverm]

.agent/

Skills seem a bit early to standardize. We are so early in this, why do we want to handcuff our creativity so soon?

[arrowsmith]

Skills are a really simple concept. They're just custom prompts with a name and some metadata. What are you afraid of handcuffing?

[nikcub]

it's actually .agents/ :)

[rvz]

There are 14 competing standards.

[d1sxeyes]

The problem is that the de facto standard is `.claude`, which is problematic for folks not using Claude.

[PurpleRamen]

Now, there are 15 competing standards.

[smithkl42]

Soon...

[behnamoh]

Worse yet; opencode uses singular words by default:

    .opencode/skill

[davidkunz]

On the website[1] it says:

  .opencode/skills

[1]: https://opencode.ai/docs/skills/#place-files

[tobyhinloopen]

ln -s to the rescue!

[smithkl42]

That doesn't work very well if your developers are on Windows (and most are). Uneven Git support for symbolic links across platforms is going to end up causing more problems than it solves.

[flurdy]

It's why I wrapped my tiny skills repo with a script that softlink them into whichever is your skills folder, defaulting to Claude, but could be any other.

I treat my skills the same as I would write tiny bash scripts and fish functions in the days gone to simplify my life by writing 2 words instead of 2 sentences. Tiny improvement that only makes sense for a programmer at heart.

[1] https://github.com/flurdy/agent-skills

[davidkunz]

The root cause should be fixed.

[xrd]

Why not hardlinks?

[throwaway98797]

might be too early to standardize

standards are good but they slow development and experimentation