addyosmani / addyosmani/agent-skills

Proposal: Optional project-level context files for team-specific skill customization

オープン
#18 コメント 3 件 リアクション 0 件 担当者 1 名 @addyosmani が担当を希望しています GitHub で見る
主要言語
JavaScript
スター
94.1k
フォーク
10k
平均マージ
3日 15時間
マージ済み PR(30日)
23

説明

Love this repo, thanks for sharing!

One thing I've noticed using skills like these across projects: the same skill often needs different conventions per team: PR size limits, legacy directory handling, test framework choices, etc. Right now that means forking the skill, which drifts from upstream.

**A pattern that's worked for me:** an optional context file in the *project* that the skill reads at runtime.

```
my-project/.claude/skills/code-review/PROJECT_CONTEXT.md
```

If it exists, the skill picks up project-specific rules. If not, it runs with defaults (same as today). Example for `code-review-and-quality`:

```markdown
## Review Standards
- Max PR size: 400 lines
- Legacy directories (safety only, not style): src/legacy/, lib/compat/
- PRs touching src/api/ require integration tests

## Team Conventions
- Conventional commits — verify PR title format
- No default exports in TypeScript
```

Skills stay generic and updatable. Context file makes them project-aware. No new tooling, just a convention in the skill anatomy spec and one skill updated as proof of concept.

Happy to draft a PR if there's interest.

コントリビューションガイド

コントリビューションガイドを開く

評価

この issue はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。