Guide for writing high-quality blip submissions for the ThoughtWorks Tech Radar. This skill should be used when someone asks for help submitting a blip to the Tech Radar, writing a radar submission, or preparing a technology recommendation for the ThoughtWorks radar.
Resources
1Install
npx skillscat add bcook797/agent-skills/tech-radar-blip Install via the SkillsCat registry.
Tech Radar Blip Submission
Overview
This skill guides users through creating compelling, well-documented blip submissions for the public ThoughtWorks Tech Radar. High-quality submissions provide sufficient detail and context to defend the blip during editorial discussions.
Submission Workflow
Step 1: Gather Core Information
To begin a blip submission, collect the following essential details from the user:
- Proposed Blip Name - The technology, tool, technique, or platform name
- What is it? - Brief description for those unfamiliar with the blip
- Why blip this now? - Current relevance and timing rationale
- What value does it provide? - Concrete benefits and outcomes
If the user is unsure about any of these, help them articulate the answers through discussion.
Step 2: Determine Placement
Help the user identify the appropriate quadrant and ring:
Quadrant (what type of blip):
- Tools - Software tools used in development or operations
- Techniques - Approaches, processes, or ways of working
- Languages & Frameworks - Programming languages or development frameworks
- Platforms - Infrastructure, cloud services, or foundational systems
Ring (maturity/recommendation level):
- Adopt - Proven, mature, industry should embrace
- Trial - Worth pursuing, used at least once in production
- Assess - Worth exploring, interesting to watch
- Caution - Proceed with care, industry should avoid (formerly "Hold")
Ring selection criteria are detailed in references/submission-guide.md.
Step 3: Gather Supporting Evidence
Strong submissions require concrete evidence:
- Production usage - Has this been used in production? (Critical for Trial ring)
- Client context - At which client(s) was this used?
- Recommending group - Which team, community, or service line recommends this?
- Vertical relevance - Is it specific to a market or industry?
- Reference URLs - Links to official sites, GitHub, blog posts, documentation
Step 4: Check for Existing Blips
If updating an existing blip's status (e.g., moving from Assess to Trial):
- Obtain the URL to the existing blip on the radar
- Explain what has changed to warrant the status update
Step 5: Draft the Submission
Compile all gathered information into a structured submission. The final output should include:
BLIP SUBMISSION
===============
Proposed Blip Name: [Name]
Quadrant: [Tools | Techniques | Languages & Frameworks | Platforms]
Ring: [Adopt | Trial | Assess | Caution]
Description:
[2-3 sentences explaining what this blip is for those unfamiliar with it]
Why Blip This Now?
[Explain current relevance, timing, and why this matters today]
Value Proposition:
[Concrete benefits and outcomes from using this]
Production Experience:
- Used in production: [Yes/No]
- Client(s): [Client names or anonymized references]
- Recommending team/community: [Team or service line name]
Vertical/Market Relevance: [Specify if applicable, or "General"]
Reference URLs:
- [URL 1]
- [URL 2]
Existing Blip URL: [If updating status, otherwise N/A]Quality Checklist
Before finalizing, verify the submission addresses these criteria:
- Clear explanation of what the blip is
- Compelling "why now" rationale with current relevance
- Concrete value proposition with specific benefits
- Appropriate quadrant selection with justification
- Ring selection supported by evidence (especially production use for Trial)
- At least 2-3 reference URLs for credibility
- Sufficient detail to defend during editorial discussions
Common Pitfalls to Avoid
- Vague descriptions - Avoid generic statements; be specific about capabilities
- Missing "why now" - Every blip needs a timely reason for inclusion
- Unsupported ring claims - Trial requires production use; Adopt requires proven maturity
- No evidence - Submissions without client context or references are difficult to defend
- Wrong quadrant - Ensure the blip fits the quadrant definition
Resources
Detailed ring criteria, quadrant definitions, and examples of strong submissions are available in references/submission-guide.md.