# Authenticated Greeting

> Secure greeting service that requires AWP authentication Use when this capability is needed.

- Skill: `tomevault-io/authenticated-greeting` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/authenticated-greeting`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/authenticated-greeting/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/authenticated-greeting

---


# Authenticated Greeting Skill

This skill provides a secure greeting service that requires AWP (Agent Web Portal) authentication. Only authenticated agents can use this skill.

## Overview

The secure greeting service is similar to the basic greeting service but requires authentication. This demonstrates AWP's authentication mechanism for protecting sensitive tools.

### Authentication Flow

1. Agent initiates AWP auth flow via `/api/auth/init`
2. User authorizes the agent in the web UI
3. Agent receives authentication token
4. Agent can now call authenticated tools

### Supported Languages

- English (en)
- Spanish (es)
- French (fr)
- German (de)
- Japanese (ja)

## Usage Examples

### Example 1: Authenticated English Greeting

Use {{secure_greet}} with just a name:

```json
{
  "name": "Alice"
}
```

**Result:**

```json
{
  "message": "Hello, Alice! (authenticated)",
  "timestamp": "2026-01-27T12:00:00.000Z"
}
```

### Example 2: Authenticated Spanish Greeting

Use {{secure_greet}} with a language code:

```json
{
  "name": "Carlos",
  "language": "es"
}
```

**Result:**

```json
{
  "message": "¡Hola, Carlos! (autenticado)",
  "timestamp": "2026-01-27T12:00:00.000Z"
}
```

### Example 3: Unauthenticated Request

If an agent tries to call {{secure_greet}} without authentication, the request will be rejected with an authentication error.

**Error Response:**

```json
{
  "error": {
    "code": -32001,
    "message": "Authentication required"
  }
}
```

## Tool Reference

### {{secure_greet}}

Generate a secure greeting message that confirms authentication.

**Input:**

- `name` (string, required): The name of the person to greet
- `language` (string, optional): The language code (en, es, fr, de, ja). Defaults to "en"

**Output:**

- `message` (string): The greeting message with "(authenticated)" suffix
- `timestamp` (string): ISO timestamp of when the greeting was generated

## Security Notes

- This tool is protected by AWP authentication
- The agent must complete the AWP auth flow before calling this tool
- Authentication tokens have a configurable expiration time
- Users can revoke agent access at any time through the web UI

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/shazhou-ww) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->

