Introduce shared-patterns/ with voice-and-tone#65
Conversation
New top-level shared-patterns/ directory holding agent-voice prompt fragments that multiple skills can reference instead of each defining their own conventions in isolation. - `voice-and-tone.md` — Asta's shared communication conventions: neutral/professional register, no emotional rapport, no cheekiness or judgmental tone, plain language with technical-term definitions, intellectual humility with categorical (not numeric) confidence labels, process rules. Adapted from Ruben Lozano Aguilera's "Asta Personality Principles" doc. - `SKILL-BOILERPLATE.md` — starting point for new Asta skills with frontmatter scaffolding, voice-and-tone reference, and optional sections. Developer-only; excluded from built plugins. Build script copies shared-patterns/ into each plugin so the relative path `../../shared-patterns/<file>` resolves the same way in both source and built artifacts. Each plugin remains self-contained. First consumer: `skills/generate-theories/SKILL.md` references voice-and-tone at the top and in the References section. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
I think we need a mechanism outside the skills to load an agent with identity tone etc. |
|
Agree. These instructions are more appropriate at the |
|
Hmm, I think we're already affecting the voice and tone, though. We're just not doing it intentionally. Multiple agents have the ability to write things. @charliemcgrady showed me an example of a theory output, and the agent sounded sarcastic and patronizing. We need to figure out a way to guide that output. If the user's agent decides to rewrite something, that's fine, just as long as we're not sending biased text in the first place. |
|
@MLatzke it sounds like you might be describing a problem with the theorizer agent that should be solved there? |
|
I agree that something like personality is best modeled via My recommendation would be to publish this in https://github.com/allenai/design.md. Then our handler + users can optionally adopt this specific personality. |
So new skills can reference the canonical asta CLI install block from SKILL-BOILERPLATE.md instead of pasting the snippet. manage-version.py now scans and rewrites the shared file alongside the per-skill copies so its pinned PLUGIN_VERSION stays consistent on `make set-version` bumps. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This PR creates a new top-level
shared-patternsdirectory that houses patterns that are shared across skills.Currently, it holds:
voice-and-tone.md— Asta's shared communication conventions: neutral/professional register, no emotional rapport, no cheekiness or judgmental tone, plain language with technical-term definitions, intellectual humility with categorical (not numeric) confidence labels, process rules. Adapted from @psesito https://docs.google.com/document/d/1OzhY7gVmtTwlnuR63vQF7fPurCWI7PCZ1IGM6gD2Pfc/edit?tab=t.0SKILL-BOILERPLATE.md— starting point for new Asta skills with frontmatter scaffolding, voice-and-tone reference, and optional sections. Developer-only; excluded from built plugins.It also updates the build script to copy shared-patterns/ into each plugin, so the relative path resolves consistently across the source and the built artifacts. Each plugin remains self-contained.
First consumer:
skills/generate-theories/SKILL.mdreferences voice-and-tone at the top and in the References section.