About tech
An Agent Skill for creating and maintaining accurate technology profiles in Rawkode Academy’s `content/technologies`. It guides research, schema-compliant metadata, and scoped edits based on primary sources.
Key features
- 01Schema and profile guidance
- 02Primary-source research rules
- 03Metadata and lifecycle constraints
- 04Scoped profile updates
Use cases
- 01Creating a new technology profile
- 02Verifying existing profile metadata
- 03Correcting profile claims and links
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ rawkode-academy/ rawkode-academy --skill techAfter installing, type/techin Claude Code to confirm it loaded.
Bundled filesagents/openai.yaml
Details
From the project READMERawkode Academy Technology Profiles
Maintain accurate, focused profiles in content/technologies.
Before Authoring
- Check whether
content/technologies/<kebab-case-slug>/index.mdxexists. - Read
content/src/technologies.tsandcontent/src/dimensions.tsas the current schema authority, then read nearby technology profiles for local frontmatter and prose conventions. - Research only from primary project sources: official site, documentation, source repository, and official licensing information.
The live schema currently requires name and website; license and status default when omitted. Add optional fields only when verified and useful: seo, logos, source, documentation, category, subcategory, aliases, relatedTechnologies, terms, cncf, community, useCases, features, learningResources, and matrix.
Profile Rules
logosrecords existing local assets with booleans only:icon,horizontal, andstackeddeclare whethericon.svg,horizontal.svg, andstacked.svgexist. It is optional; never invent, download without provenance, or create placeholder assets.- Use one optional singular
categoryand one optional singularsubcategory; do not usecategories. - Use lifecycle
statusonly from:alpha,beta,stable,preview,superseded,deprecated, orabandoned. - If adding
matrix, its requiredstatusis one ofskip,watch,explore,learn,adopt,advocate,graveyard, orguilty-pleasure. Its optionalgrouping,confidence, andtrajectoryrespectively useplumbing/platform/observability/security,gut/some-experience/deep-experience, andrising/stable/falling. - Do not add obsolete frontmatter such as top-level
description,categories, or aradarblock.
Create or Update
For a new profile, create only the needed directory, index.mdx, and verified logo files. Write concise, objective MDX grounded in the sources. For an existing profile, first verify its metadata, terminology, links, and claims, then make the narrowest correction that resolves the request. Preserve useful existing content and established nearby style.
Guardrails
- Prefer primary sources and distinguish verified facts from uncertain claims.
- Do not invent metadata, URLs, capabilities, relationships, or asset provenance.
- Keep changes scoped to the requested technology; avoid broad rewrites and unrelated files.
- Report what was verified, changed, and left unresolved.